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ABSTRACT 

A method of creating an image is disclosed. The image is formed by rendering and 
compositing at least a plurality of graphical objects whereby each of the objects has a 
5 predetermined outline. The method comprises the following steps. Firstly, dividing a 
space in which the outlines are defined into a plurality of regions whereby each of the 
regions is defined by at least one region outline. The region outline substantially follows 
at least one of the predetermined outlines or parts thereof and is substantially formed by 
segments of a virtual grid encompassing the space. Secondly, manipulating the regions to 

10 determine a plurality of further regions whereby each of the further regions has a 
corresponding compositing expression. Fourthly, classifying the further regions 
according to at least one attribute of the graphical objects within the further regions. 
Fifthly, modifying each of the corresponding compositing expressions according to a 
classification of each of the further regions to form an augmented compositing expression 

15 for each of the further regions. Finally, compositing the image using each of the 
augmented compositing expression. 
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The claims defining the invention are as follows: 

1 . A method of creating an image, said image to be formed by rendering and 

compositing at least a plurality of graphical objects, each said object having a 

5 predetermined outline, said method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality regions, each 
said region being defined by at least one region outline substantially following at least 
one of said predetermined outlines or parts thereof and being substantially formed by 
segments of a virtual grid encompassing said space; 
10 , manipulating said regions to determine a plurality of further regions, wherein each 
said further region has a corresponding compositing expression; 

classifying said further regions according to at least one attribute of said graphical 
objects within said further regions; 

modifying each said corresponding compositing expression according to a 
15 classification of each said further region to form an augmented compositing expression 
for each said further region; and 

compositing said image using each of said augmented compositing expressions. 

2. A method according to claim I, wherein said attribute is selected from 
20 the group consisting of colour, opacity and object outline. 

3. A method according to claims 1 or 2, wherein said manipulating said 
regions comprises applying set operations to said regions. 

25 4. A method according to claim 3, wherein said set operations include 

difference and/or intersection operations. 

5. A method according to any one of the preceding claims, wherein said 
grid is regularly spaced and preferably orthogonally based. 

30 

6. A method according to any one of claims 1 to 4, wherein said grid is 
irregularly shaped. 



7. A method according to any one of claims 1 to 6, wherein the compositing 
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REGION BASED IMAGE COMPOSITING 

Field of the Invention 

The present invention relates to the creation of computer-generated images both in 
the form of still pictures and video imagery, and, in particular, relates to efficient process, 
5 apparatus, and system for creating an image made up by compositing multiple 
components. 

Background 

Computer generated images are typically made up of many differing components or 
graphical elements which are rendered and composited together to create a final image. 

10 In recent times, an "opacity channel" (also known as a "matte", an "alpha channel", or 
simply "opacity") has been commonly used. The opacity channel contains information 
regarding the transparent nature of each element. The opacity channel is stored alongside 
each instance of a colour, so that, for example, a pixel-based image with opacity stores an 
opacity value as part of the representation of each pixel. An element without explicit 

15 opacity channel information is typically understood to be fully opaque within some 
defined bounds of the element, and assumed to be completely transparent outside those 
bounds. 

An expression tree offers a systematic means for representating an image in terms 
of its constituent elements and which facilitates later rendering. Expression trees 

20 typically comprise a plurality of nodes including leaf nodes, unary nodes and binary 
nodes. Nodes of higher degree, or of alternative definition may also be used. A leaf 
node, being the outer most node of an expression tree, has no descendent nodes and 
represents a primitive constituent of an image. Unary nodes represent an operation which 
modifies the pixel data coming out of the part of the tree below the unary operator. 

25 Unary nodes include such operations as colour conversions, convolutions (blurring etc) 
and operations such as red-eye removal. A binary node typically branches to left and 
right subtrees, wherein each subtree is itself an expression tree comprising at least one 
leaf node. Binary nodes represent an operation which combines the pixel data of its two 
children to form a single result. For example, a binary node may be one of the standard 

30 "compositing operators" such as OVER, IN, OUT, ATOP and alpha-XOR, examples of 
which and other are seen in Fig. 20. 

Several of the above types of nodes may be combined to form a compositing tree. 
An example of this is shown in Fig. 1 . The result of the left-hand side of the compositing 
tree may be interpreted as a colour converted image being clipped to spline boundaries. 
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This construct is composited with a second image. 

Although the non-transparent area of a graphical element may of itself be of a 
certain size, it need not be entirely visible in a final image, or only a portion of the 
element may have an effect on the final image. For example, assume an image of a 

5 certain size is to be displayed on a display. If the image is positioned so that only the top 
left comer of the image is displayed by the display device, the remainder of the image is 
not displayed. The final image as displayed on the display device thus comprises the 
visible portion of the image, and the invisible portion in such a case need not be rendered. 
Another way in which only a portion of an element may have an effect is when the 

10 portion is obscured by another element. For example, a final image to be displayed (or 
rendered) may comprise one or more opaque graphical elements, some of which obscure 
other graphical elements. Hence, the obscured elements have no effect on the final 
image. 

A conventional compositing model considers each node to be conceptually infinite 
15 in extent. Therefore, to construct the final image, a conventional system would apply a 
compositing equation at every pixel of the output image. Interactive frame rates of the 
order greater than 15 frames per second can be achieved by relatively brute-force 
approaches in most current systems, because the actual pixel operations are quite simple 
and can be highly optimised. This highly optimised code is fast enough to produce 
20 acceptable frame rates without requiring complex code. However, this is certainly not 
true in a compositing environment. 

The per-pixel cost of compositing is quite high. This is because typically an image 
is rendered in 24-bit colour in addition to an 8-bit alpha channel, thus giving 32 bits per 
pixel. Each compositing operator has to deal with each of the four channels. Therefore, 
25 the approach of completely generating every pixel of every required frame when needed 
is inefficient, because the per-pixel cost is too high. 

Problems arise with prior art methods when rendering graphical objects which 
include transparent and partially-transparent areas. Further, such methods typically do 
not handle the full range of compositing operators. 
30 Summary of the Invention 

It is an object of the present invention to substantially overcome, or ameliorate, one 
or more of the deficiencies of the above mentioned methods by the provision of a method 
for creating an image made up by compositing multiple components. 

According to one aspect of the present invention there is provided a method of 
35 creating an image, said image to be formed by rendering and compositing at least a 
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plurality of graphical objects, each said object having a predetermined outline, said 
method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality regions, each 
said region being defined by at least one region outline substantially following at least 
5 one of said predetermined outlines or parts thereof and being substantially formed by 
segments of a virtual grid encompassing said space; 

manipulating said regions to determine a plurality of further regions, wherein each 
said further region has a corresponding compositing expression; 

classifying said further regions according to at least one attribute of said graphical 
1 0 objects within said further regions; 

modifying each said corresponding compositing expression according to a classifi- 
cation of each said further region to form an augmented compositing expression for each 

said further region; and 

compositing said image using each of said augmented compositing expressions. 

1 5 According to another aspect of the present invention there is provided a method of 

method of creating an image, said image to be formed by rendering and compositing at 
least a plurality of graphical objects, each said object having a predetermined outline, said 
method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality regions, each 

20 said region being defined by at least one region outline substantially following at least 
one of said predetermined outlines or parts thereof and being substantially formed by 
segments of a virtual grid encompassing said space, wherein each object has two region 
outlines arranged either side of said predetermined outline to thus define three regions for 
each said object, and wherein each said region has a corresponding compositing 

25 expression; 

classifying said regions according to at least one attribute of said graphical objects 
within said regions; 

modifying each said corresponding compositing expression according to a 
classification of each said region to form an augmented compositing expression for each 

30 said region; and 

compositing said image using each of said augmented compositing expressions. 
According to still another aspect of the present invention there is provided an 
apparatus for creating an image, said image to be formed by rendering and compositing at 
least a plurality of graphical objects, each said object having a predetermined outline, said 
35 apparatus comprising: 
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dividing means for dividing a space in which said outlines are defined into a 
plurality regions, each said region being defined by at least one region outline 
substantially following at least one of said predetermined outlines or parts thereof and 
being substantially formed by segments of a virtual grid encompassing said space; 
5 manipulating means for manipulating said regions to determine a plurality of further 

regions, wherein each said further region has a corresponding compositing expression; 

classifying means for classifying said further regions according to at least one 
attribute of said graphical objects within said further regions; 

modifying means for modifying each said corresponding compositing expression 
10 according to a classification of each said further region to form an augmented 
compositing expression for each said further region; and 

compositing means for compositing said image using each of said augmented 
compositing expressions. 

According to still another aspect of the present invention there is provided an 
1 5 apparatus for creating an image, said image to be formed by rendering and compositing at 
least a plurality of graphical objects, each said object having a predetermined outline, said 

apparatus comprising: 

dividing means for dividing a space in which said outlines are defined into a 

plurality regions, each said region being defined by at least one region outline 
20 substantially following at least one of said predetermined outlines or parts thereof and 

being substantially formed by segments of a virtual grid encompassing said space, 

wherein each object has two region outlines arranged either side of said predetermined 

outline to thus define three regions for each said object, and wherein each said region has 

a corresponding compositing expression; 
25 classifying means for classifying said regions according to at least one attribute of 

said graphical objects within said regions; 

modifying means for modifying each said corresponding compositing expression 

according to a classification of each said region to form an augmented compositing 

expression for each said region; and 
30 compositing means for compositing said image using each of said augmented 

compositing expressions. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium having a plurality of 
software modules for creating an image, said image to be formed by rendering and 
35 compositing at least a plurality of graphical objects, each said object having a 
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predetermined outline, said computer program product comprising: 

dividing module for dividing a space in which said outlines are defined into a 
plurality regions, each said region being defined by at least one region outline 
substantially following at least one of said predetermined outlines or parts thereof and 
5 being substantially formed by segments of a virtual grid encompassing said space; 

manipulating module for manipulating said regions to determine a plurality of 
further regions, wherein each said further region has a corresponding compositing 
expression; 

classifying module for classifying said further regions according to at least one 
1 0 attribute of said graphical objects within said further regions; 

modifying module for modifying each said corresponding compositing expression 
according to a classification of each said further region to form an augmented 
compositing expression for each said further region; and 

compositing module for compositing said image using each of said augmented 

1 5 compositing expressions. 

According to still another aspect of the present invention there is provided a 
computer program product including a computer readable medium having a plurality of 
software modules for creating an image, said image to be formed by rendering and 
compositing at least a plurality of graphical objects, each said object having a 

20 predetermined outline, said computer program product comprising: 

dividing module for dividing a space in which said outlines are defined into a 
plurality regions, each said region being defined by at least one region outline 
substantially following at least one of said predetermined outlines or parts thereof and 
being substantially formed by segments of a virtual grid encompassing said space, 

25 wherein each object has two region outlines arranged either side of said predetermined 
outline to thus define three regions for each said object, and wherein each said region has 
a corresponding compositing expression; 

classifying module for classifying said regions according to at least one attribute of 
said graphical objects within said regions; 

30 modifying module for modifying each said corresponding compositing expression 

according to a classification of each said region to form an augmented compositing 
expression for each said region; and 

compositing module for compositing said image using each of said augmented com- 
positing expressions. 
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Brief Description of the Drawings 

A preferred embodiment of the present invention will now be described with 
reference to the following drawings: 

Fig. 1 is an example of a compositing tree; 

Fig. 2 illustrates an image containing a number of overlapping objects and the 
corresponding compositing tree; 

Fig. 3 shows the image of Fig. 2 illustrating the different regions which exist in the 
image and listing the compositing expression which would be used to generate the pixel 
data for each region; 

Fig. 4 is the image of Fig. 3, illustrating the compositing operations after being 
optimised according to one example of the preferred embodiment; 

Fig. 5 illustrates the result of combining two region descriptions using the Union 
operation according to the preferred embodiment; 

Fig. 6 illustrates the result of combining two region descriptions using the 
Intersection operation according to the preferred embodiment; 

Fig. 7 illustrates the result of combining two region descriptions using the 
Difference operation according to the preferred embodiment; 

Figs. 8A to 8D illustrate the steps involved in combining two region groups using 
the Over operation according to the present invention; 

Fig. 9 illustrates an image and compositing tree according to another example of the 

preferred embodiment; 

Fig. 10 illustrates an image and compositing tree according to still another example 

of the preferred embodiment; 

Fig. 1 1 illustrates the effect on the image of Fig. 10 of moving region A; 

Fig. 12 illustrates an image and compositing tree according to still another example 
of the preferred embodiment; 

Fig. 13 illustrates the effect on the image of Fig. 12 of moving region A; 

Fig. 14 illustrates the effect on the image of Fig. 12 of moving region B; and 

Fig. 15 illustrates those nodes in a compositing tree which need to have their region 
groups updated if leaf nodes B and H change; 

Fig. 1 6 illustrates a region and its x and y co-ordinates; 

Fig. 17 illustrates two regions and their x and y co-ordinates; 

Fig. 18 illustrates an image and compositing tree according to still another example 
of the preferred embodiment; 

Fig. 19 illustrates an apparatus upon which the preferred embodiment is 
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implemented; 

Fig. 20 depicts the result of a variety of compositing operators useful with the 
present invention; 

Fig. 21 illustrates regions formed by combining two circles with non-grid-aligned 

5 regions; 

Fig. 22 illustrates improved regions formed by combining two circles with grid- 
aligned regions; 

Fig. 23 is a flowchart showing a method of creating an image in accordance with 
the preferred embodiment; and 
10 Appendix 1 is a listing of source code according to the present invention 

Detailed Description 

1 .0 Underlying Principles 

' The basic shape of operands to compositing operators in most current systems is the 
rectangle, regardless of the actual shape of the object being composited. It is extremely 

1 5 easy to write an operator which composites within the intersection area of two bounding 
boxes. However, as a bounding box typically does not accurately represent the actual 
bounds of a graphical object, this method results in a lot of unnecessary compositing of 
completely transparent pixels over completely transparent pixels. Furthermore, when the 
typical make-up of a composition is examined, it can be noticed that areas of many of the 

20 objects are completely opaque. This opaqueness can be exploited during the compositing 
operation. However, these areas of complete opaqueness are usually non-rectangular and 
so are difficult to exploit using compositing arguments described by bounding boxes. If 
irregular regions are used for exploiting opaque objects when compositing, then these 
regions could then be combined in some way to determine where compositing should 

25 occur. Furthermore, if any such region is known to be fully transparent or fully opaque, 
further optimisations are possible. 

Most current systems fail to exploit similarities in composition between one frame 
and the next. It is rare for everything to change from frame to frame and therefore large 
areas of a compositing tree will remain unchanged. An example of this is where a 

30 cartoon type character comprising multiple graphical objects is rendered on a display. If, 
for example, the character spilt some paint on its shirt in the next frame, then it is not 
necessary to render the entire image again. For example, the head and legs of the 
character may remain the same. It is only necessary to render those components of the 
image that have been altered by the action. In this instance, the part of the shirt on which 

35 the paint has been spilt may be re-rendered to be the same colour as the paint, whilst the 
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remainder of the character stays the same. Exploiting this principle may provide large 
efficiency improvements. If incremental changes are made to the compositing tree, then 
only a reduced amount of updating is necessary to affect the change. 

Many current graphical systems use what is known as an immediate mode 

5 application program interface (API). This means that for each frame to be rendered, the 
complete set of rendering commands is sent to the API. However, sending the complete 
set of rendering commands is somewhat inefficient in a compositing environment, as 
typically, large sections of the compositing tree will be unchanged from one frame to the 
next, but would be completely re-rendered anyway in immediate mode. The preferred 

10 embodiment, on the other hand, is considered by the present inventors lo be best 
described as a retained mode API. Retained mode means that instead of providing the 
complete compositing tree on a per-frame basis, the user provides an initial compositing 
tree, and then modifies it on a per-frame basis to effect change. Changes which can be 
made to the tree include geometrically transforming part or all of the tree, modifying the 

15 tree structure (unlinking and linking subtrees), and modifying attributes (eg: color) of 
individual nodes. Note that such modifications may not necessarily mean that the tree 
structure, lor example as seen in Fig. 1, will change where only the attributes of an 
individual node have been modified. 

The rendering operation of the preferred embodiment is a combination of a number 

20 of techniques and assumptions which combine to provide high quality images and high 
frame rates. Some of the contributing principles are: 

(i) The use of irregular regions to minimise per-pixel compositing. For example, 
if one graphical object is on top of another, then pixel compositing is only needed inside 
the area where the two objects intersect. Having the ability to use irregular regions gives 

25 the ability to narrow down areas of interest much more accurately. 

(ii) An assumption is made that in the transition from one frame to the next, only 
part of the tree will change. This can be exploited by caching away expensive-to- 
generate information regarding the composition so that it can be re-used from one frame 
to the next. Examples of expensive-to-generate information are - regions of interest 

30 (boundaries of areas of intersection between objects etc); pixel data (representing 
expensive composites etc); and topological relationships between objects. 

(iii) If an opaque object is composited with another object using the OVER opera- 
tor, then the opaque object completely obscures what it is composited onto (inside the 
opaque objects area). This is a very useful property because it means that no expensive 

35 pixel compositing is required to achieve the output pixel within the area of overlap. ,(The 
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pixel value is the same as thai at the equivalent spot on the opaque object). Opaqut 
objects induce similar behaviour in most of the compositing operators. Therefore, th< 
preferred embodiment attempts to exploit opaque areas as much as possible. 

Fig. 23 is a flowchart showing a method of creating an image in accordance wit! 
5 the preferred embodiment of the present invention. The image is formed by rendering 
graphical objects whereby each of the objects has a predetermined boundary outline. Tin 
process begins at step 2301, where a space in which the object outlines are defined i: 
divided into a number of regions. Each of the regions is defined by at least one of th< 
predetermined boundary outlines or parts thereof. The regions are formed by segments o 

10 a grid which encompasses the space in which the predetermined outlines are defined. A 
the next step 2303, the regions are manipulated to determine a number of further regions 
Each of the further regions has a corresponding compositing expression. The process o 
dividing the space into a number of regions and manipulating those regions is describee 
in detail particularly with reference to section 2.3 below. Section 2.3 includes tw< 

15 pseudocode listings which describe steps 2301 and 2303 for the "OVER" and "IN" 
compositing operations. The process continues at step 2305, where the further region 
are classified according to attributes of the objects that fall within the further regions. A 
the next step 2307, each of the corresponding compositing expressions are modifie< 
according to a classification of each of the further regions. The modifications form ai 

20 augmented compositing expression for each of the further regions. The process o 
classifying the further regions and modifying each of the corresponding compositin; 
expressions is described in detail particularly with reference to section 2.4 below. Sectio 
2.4 includes two pseudocode listings which describe steps 2305 and 2207 for th 
"OVER" and "IN" compositing operations. The process concludes at step 2309, wher 

25 the image is composited using each of the augmented compositing expressions. Ste 
2309 is described in detail with reference to section 2.6, below, which includes 
pseudocode listing demonstrating the compositing process. 
2.0 Basic Static Rendering 

Static Rendering deals with the problem of generating a single image from 

30 compositing tree as quickly as possible. Some of the pixel compositing methods of th 
preferred embodiment will be explained using a static rendering example. 

An example of a simple compositing tree which consists of leaf node objects an 
only using the "OVER" operator is shown in Fig. 2. Conventionally, each node 
considered to be conceptually infinite in extent. One method to construct the final imaj. 

35 is to apply the compositing equation (((D OVER B) OVER C) OVER (A OVER E)) 
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2.1 Basic Data Modcfl 

Associated with every node in a compositing tree is a group of mutually exclusive 
regions which together represent the non-transparent area of the node. It should be noted 
that the region descriptions that the preferred embodiment uses are generally not pixel 
accurate. A region may in fact contain some transparent pixels. However, any point 
lying outside of all the regions at a node is certain to be transparent. The set of the 
mutually exclusive regions at a node is known as a region group. A leaf node region 
group may contain only one or two regions. The region group at the root of the tree may 
contain hundreds of regions. Each region in a region group contains the following basic 
data: 

(i) A Region Description is a low-level representation of the boundaries of the 
region. The region descriptions of all the regions in a region group must be mutually 
exclusive (non-intersecting). However, the preferred embodiment is not limited to using 
axis-parallel (ie: every side parallel or perpendicular to a scan line of an output device) 
region descriptions. The preferred embodiment allows region descriptions which more 
closely represent arbitrary shaped regions. 
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(ii) A Proxy is some means of caching the pixel data resulting from applying the 
operations specified by the compositing expression at every pixel inside the region 
description. A proxy can be as simple as a 24-bit colour bitmap, or something much 
more complicated (such as a run-length encoded description). Fundamentally, a proxy 
5 simply has to represent pixel data in some way which makes it efficient to retrieve and 
use. 

Every region group also contains a region description which is the union of all the 
region descriptions of the regions in the region group. The region description essentially 
represents the entire coverage of the region group. 
1 0 2.2 Region Descriptions and Region Arithmetic 

The region arithmetic and data structure of the preferred embodiment has the 
following properties: 

-to allow the representation of complex regions, including convex regions, concave 
regions and regions with holes. This is necessary so that a region will be reasonably able 
1 5 to follow the geometry of the graphic object it represents; 

-is space efficient. In a complicated composition there will be many regions. For 
memory efficiency, it is therefore preferable that the cost of storing these regions is 
reasonably small; 

-the region arithmetic should support basic set operations - Union, Intersection and 
20 Difference; 

-the above-noted basic operations should be efficient in terms of speed. In a complex 
compositing tree, it is possible that a large amount of region arithmetic will be 
undertaken. A poor implementation of region arithmetic could lead to the time taken by 
region arithmetic being greater than the time saved from the reduction in per-pixel 
25 compositing; 

-it is advantageous if the region description can be geometrically translated efficiently. 
In cases where a graphic object is translated, the graphics objects associated regions can 
then be translated quickly; and 

-it is sometimes helpful to be able to quickly compare two regions to determine if they are 
30 the same. It is not necessary to obtain any other statistics on their similarity, simple 
equality is all that is required. 

Two conventional region description techniques were considered and rejected for the 
preferred embodiment. These were- 

I'olygons: A polygon can be used to represent almost any object, the disadvantage 
35 of using a polygon, however, is that a ploygon's generality makes implementing the set 
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operations slow and inefficient. 

Quadtrees: Using quadtrees, set operations are easy to implement and are quite 
efficient. In addition, they can represent a wide variety of regions given sufficient 
granularity (all edges in a quadtree have to be axis-parallel). Their major failing is that all 
5 quadtrees must be aligned on the same grid (granularity). This means that it is impossible 
lo simply translate a quadtree by an arbitrary amount. Unless that amount is a multiple of 
the underlying grid size, the quadtree will need to be recalculated from the object it 
describes (otherwise it will keep growing). Therefore, quadtrees are not suitable in 
application domains where geometric translation is a frequent operation. 
10 The region description data structure of the preferred embodiment can be 

understood by imagining that along a vertical line every coordinate has a state which is 
one of either inside or outside the region. The data structure stores those y co-ordinates at 
which some change of state between inside and outside occurs. For each such y 
co-ordinate, the data contains spans of coordinates each of which toggles the state of 
1 5 every vertical line running through the data. Each span of x co-ordinates is called a run. 
The sequence of runs associated with a y co-ordinate is called a row. For example, the 
region of Fig. 16 could be described by the following: 
rowy= 10:x = 10, x = 100 
rowy = 100: x= 10, x =100 
20 Similarly, the regions of Fig. 1 7 could be described by the following: 
rowy= 10 :x = 10, x =100 
row y = 30 : x = 30, x = 70 
row y = 70 : x = 30, x = 70 
rowy = 100: x +10, x = 100 
25 The data representing a region is represented by an array of integer values. There are two 

"special" values - 

R NEXT IS Y A beginning-of-row marker. Indicates that the next integer in the 

— — — se q U ence will represent a y coordinate. 

R E0R Stands for End-of-Region. Indicates that the region description has 

~~ finished. 

All other values represent x or y coordinates. The x coordinates in a row represent 
30 runs. The first two co-ordinates represent a run, then the next two represent the next run 
and so on. Therefore, the x coordinates in a row should always be increasing. Also, there 
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should always be an even number of x-coordinates in a row. The region data stream for 
Fig. 1 7 is shown below. 

R_NEXT_IS_Y 10 10 100 
5 R_NEXT_IS_Y 30 30 70 

R_NEXT_IS_Y 70 30 70 
R_NEXT_IS_Y 100 10 100 
R_EOR 

The preferred embodiment also contains the bounding box of the region, as this is 

1 0 useful in certain set operations. 

As seen in Fig. 6, if two region descriptions are combined using a Union operation, 
then the resultant region description will describe an area in which either region 
description is active. 

As seen in Fig. 7, if two region descriptions are combined using the Intersection 
15 operation, then the resultant region description will describe an area in which both the 
region descriptions are active. 

If two region descriptions are combined using the Difference operation, then the 
resultant region will describe an area in which only the first region is active, as seen in 
Fig. 8. 

20 

2.3 Constructing Region Groups: 

2.3.1 Constructing Leaf Node Region Groups 

A region group for a leaf node will typically contain one or more regions, which 
together fully contain the non-transparent area of the graphical object represented by the 

25 leaf node. Typically, the non-transparent area is divided into regions where each region 
has some property that facilitates optimization. For example, the non-transparent area of 
some graphical object can be divided into two regions, one fully opaque and the other 
with ordinary opacity. The above mentioned compositing optimizations would apply 
where the opaque region is composited. 

30 Alternatively, the leaf node could be subdivided based on some other attribute. For 

example, a leaf node could be divided into two regions, one representing an area of 
constant colour, the other representing blended colour. Areas of constant colour may be 
composited more efficiently than areas with more general colour description. 
2.3.1.1 Region Formation and Phasing 

35 When creating regions, it is not always beneficial that region boundaries follow 

graphical object boundaries precisely. What is important is that any property that 
facilitates optimization is valid at all points within a region said to have that property. 
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For example, an opaque circle could be covered exactly by one circular region which is 
classified as opaque, or by two approximate regions, one fully opaque octagonal region 
inscribed in the circle, and one annular octagonal region of ordinary opacity that includes 
the remainder of the circle plus some area exterior to the circle. 

There is typically a trade-off between how closely region boundaries follow 
graphical object boundaries and the benefits obtained. If region boundaries follow object 
boundaries very closely, a lot of work is usually involved in creating the region 
boundaries and in performing intersections and differences of regions (the reasons for 
needing to perform such operations are explained in later sections). However, if region 
boundaries are too approximate, they may either include large areas that are outside the 
objects' boundaries, resulting in too much unnecessary compositing, or they may fail to 
include large areas where known properties lead to optimization. 

One approach, as illustrated in the appendix, is to limit region boundaries to 
sequences of horizontal and vertical segments. Using this approach, the typical segment 
size is chosen so that there is neither too much detail so that the region operations are 
overburdened, nor too much approximation to result in wasted compositing or insufficient 
optimization. 

One method to improve the efficiency of region operations is to choose as many as 
is practical of the horizontal and vertical segments of substantially all region boundaries 
to be in phase. In other words, the horizontal and vertical segments are to be chosen from 
the horizontal and vertical lines of the same grid. The grid need not be regularly spaced, 
nor have the same spacing horizontally and vertically, although typically it will. 

Choosing the horizontal and vertical segments from the horizontal and vertical lines 
of the same grid improves the efficiency of region operations by seeking to keep all 
region boundary detail to the level of detail contained in the underlying grid. Without 
constraining the majority of region boundary segments to a grid, region operators such as 
difference and intersection tend to produce a lot more fine detail. For example, in Fig. 
21, two circles 901 and 902 are shown with respective regions 903 and 904 that are not 
grid-aligned. These circles are overlapped yielding difference regions 905 and 907, and 
intersection region 906. In Fig. 22, the same circles 901 and 902 have regions 913 and 

914 that are aligned to grid 910. These circles are overlapped yielding difference regions 

915 and 917 and intersection region 916. It can be seen in this example that the grid- 
aligned regions yield less detailed results at the expense of slightly less efficient region 
coverage. Regions 905, 906 and 907 together contain a total of sixty segments, while 
regions 915, 916 and 917 together contain only fifty-two. 



ll:\l-:i.EC\CISKA\OI'l:NSCRN\0 SCRNOI |47I440.«Iiic:IAO 



- 17- 



2.3.2 Creating Binary Region Groups 

The region groups of binary nodes in the compositing tree on the other hand are the 
result of combining the region groups of their child nodes. It will now be explained how 
region groups are combined to form new region groups. In this section, for simplicity 
only "OVER" and "IN" binary nodes will be dealt with. The operations required for 
binary nodes representing other compositing operators can easily be inferred from 
combining the "OVER" and "IN" cases in various ways. 

For the sake of clarity, the method of the preferred embodiment is initially 
described without reference to optimization based properties such as opacity. 

The following notation will be beneficial when considering binary region group 
creation: 

Notation 



RG1 


The region group of the binary node's left child 


RG2 


The region group of the binary node's right child 


RG 


The region group of the binary node. It is this region group 
that is being initialised 


RGl->urgn 


The region description representing the union of all RGl's 
region descriptions (RGl's coverage region). 


RG2->urgn 


The region description representing the union of all RG2's 
region descriptions (RG2's coverage region). 


RG->urgn 


The union of all RG's region descriptions (to be initialised) 
(RG's coverage region) 


rgli 


The current region in RG 1 


rg2j 


The current region in RG2 


rgli->rgn 


rgli's region description 


rg2j->rgn 


rg2j's region description 


rgli->proxy 


rgli's proxy 


rg2j->proxy 


rg2j's proxy 



2.3.2.1 Constructing "OVER" Region Groups 

When constructing "OVER" region groups, only areas where the contributing 
region groups intersect need to be composited. Areas where one operand does not 
overlap the other involve no compositing. The method is broken into three iterative steps. 
First, the coverage region of the region group of the binary node that is being initialised 
(RG->urgn) is made equal to the union of the coverage regions of the binary nodes left 
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child (RGl->urgn) and the binary node's right child (RG2->urgn). Then, for each region 
rgi in RGl, the difference (diff_rgn) between that region and RG2's coverage region 
(RG2->urgn) is then calculated. If the difference (diff_rgn) is non-empty then a new 
region with diffrgn as its region description is added to RG. The proxy of this new 

5 difference region can be the same as the proxy rgli. No compositing is required to 
generate it. The difference regions between RG2's regions and RGl's coverage region are 
similarly constructed and added to RG. Finally, the intersection (inter_rgn) between each 
region rglj in RGl and each region rg2 3 in RG2 is calculated. If the result of this 
intersection is non-empty, then a new proxy (new_p) is created by compositing rglj's 

1 0 proxy with rg2/s proxy using the over operation with the inter_rgn. A new region is then 
added to RG with inter_rgn as its region description and new_p as its proxy. The method 
of constructing "OVER" groups in accordance with the preferred embodiment is 
described below using pseudo-code. 

15 RG->urgn = RG1->urgn union RG2->urgn 
FOR i = 0 TO number of regions in RG1 DO 
diff_rgn = rg1j-*rgn difference RG2->urgn 
IF diff_rgn is non-empty THEN 

ADD to RG a new region with diff_rgn as its region description and 
20 rg1j->proxy as its proxy. (*) 
END IF 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1j->rgn intersection rg2j->rgn 
IF inter_rgn is non-empty THEN 
25 create new proxy new_p initialised to OVER of rg1 j->proxy and 

rg2j->proxy inside inter_rgn. 

ADD to RG a new region with inter_rgn as its region description 

and new_p as its proxy. (+) 
END IF 
30 END DO 

END DO 

FOR j = 0 TO number of regions in RG2 DO 
diff_rgn = rg2j->rgn difference RG1->urgn 
IF diff_rgn is non-empty THEN 
35 ADD to RG a new region with diff_rgn as its region description and 
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rg2j->proxy as its proxy. (*) 

END IF 
END DO 

5 The regions added by the ADD operations marked with asterisks (*) above are 

termed difference regions since their shape is the result of a difference operation. Such 
regions are very cheap computationally because their proxies require no compositing. 
The only work involved is the administrative overhead of adding a new region to the 
region group and the cost of the difference operation itself. In accordance with the 
10 preferred embodiment, a proxy is inherited from the region (in one of the child region 
groups) on which it is based. It can be seen that proxies which originate low in the 
compositing tree can be propagated upwards towards the root with minimal overhead 
(both in terms of speed and memory) by the use of difference regions. 

The regions added by the ADD operation marked with the plus (+) are termed 
1 5 intersection regions. This is because their shape is the result of an intersection operation. 
The proxies of such regions are more expensive to generate than difference regions 
because they involve per-pixel compositing operations to be done within the area defined 
by the intersection. The more fidelity granted the region descriptions, the greater the 
saving in pixel processing costs, at the cost of a greater administrative overhead (more 
20 complex regions require longer to intersect etc). 

Figs. 8A to 8D provide a simple example of combining "OVER" region groups 
using the above method. The region group resulting from the combination contains 5 
regions, 3 difference regions and- 2 are intersection regions. Fig. 8A represents two 
region groups RG1 and RG2 which are to be combined. RG1 contains two regions 81 
25 and 82, whereas RG2 only contains a single region 83. As seen in Fig 8B, for each region 
in RG1, RG2's region coverage is subtracted from it. If the resultant region is non-empty, 
the resultant region becomes a region in the new region group. In this example both 
regions 81 and 83 produce non-empty difference regions 84 and 85 respectively. For 
each region in RG2, RGl's region coverage is subtracted from it, as seen in Fig 8C. In 
30 this example difference region 86 is produced. Finally, every region in RG1 is 
intersected with every region in RG2, as seen in Fig 8D. Any non-empty region becomes 
a region in the new region group. In this example, regions 81 and 83 produce 87. 
Further, regions 82 and 83 produce 88. 
2.3.2.2 Constructing "IN" Region Groups 
35 The properties of the "IN" operator lead to the fact that an "IN" binary region group 
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only produces pixel data in the region of intersection between the two contributing region 
groups. Essentially, when compared to the algorithm used for "OVER" region groups, 
only intersection regions are generated. Therefore, for each region rgh of RG1, and for 
each region rg2j of RG2 the intersection (inter_rgny) between rgli and rg2j is calculated, 
if the intersection is non-empty then a new proxy (new_p) is created by compositing 
rglj's proxy with rg2/s proxy using the "in" operation within interj-gny. A new region is 
then added to RG with inter_rgn as its region description and new_p as its proxy. The 
pseudocode describing the method of constructing "IN" region groups in accordance to 
the preferred embodiment is provided below: 



RG->urgn = RG1-»urgn intersection RG2->urgn 
FOR i = 0 TO number of regions in RG1 DO 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1j->rgn intersection rg2j->rgn 
IF interjgn is non-empty THEN 

create new proxy new_p initialised to IN of rg1j-»proxy and 

r g2j->proxy inside inter_rgn. 

ADD to RG a new region with inter_rgn as its region description 

and new_p as its proxy. (+) 
END IF 
END DO 
END DO 

The major difference between the "IN" and the "OVER" cases is that the "OVER" 
case generates difference regions while "IN" does not. In the example demonstrated by 
Figs. 8A to 8D, only new regions 97 and 98 would be generated, as these are intersection 
regions. Difference regions 94, 95 and 96 would not be generated using "IN". 

Using Table 2 below and the pseudocode examples of "OVER" and "IN", the 
relevant code for other compositing operators can be derived. 
2.3.2.3 Constructing Region Groups of Other Compositing Operators 

Other compositing operators typically generate the same intersection regions as the 
"OVER" and "IN" cases do. However, they typically differ from one another (as indeed 
from "OVER" and "IN") in what difference regions they generate. This is dependent on 
the particular properties of each compositing operator. Table 2 summarises which differ- 
ence regions are generated for some commonly used compositing operators. 
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TABLE 2 



Compositing Operator 


Generate Diff Rgns from 
RG1 ? 


Generate Diff Rgns from 
RG2? 


Over 


Yes 


Yes 


In 


No 


No 


Out 


Yes 


No 


Atop 


No 


Yes 


Xor 


Yes 


Yes 


Plus 


Yes 


Yes 



2.4 Optimising using Opaque Areas 

The preferred embodiment stores within each region a flag indicating whether the 
pixel data in the region proxy is completely opaque. It is therefore possible to reduce the 
number of per-pixel compositing operations by exploiting the effect opaque operands 
have on the compositing operators. 

2.4.1 Opaque Area Optimisation for "Over" Region Groups 

If an opaque region is "OVER" another region, then there is no need to compute the 
result of the composite, as no part of the right operand region's proxy is visible through 
the left operand's opaque proxy. In the preferred embodiment, the resultant region is 
made to reference the right operand's proxy, which has the same effect as actually doing 
the composite. 

The method for opaque area optimisation for "OVER" region groups is a slightly 
modified version of the "OVER" region group construction method provided previously. 
The only difference is that when calculating the intersection region of the current region 
in RG1 and each region of RG2, a check is carried out to see whether the current region 
in RG1 is opaque. If this is the case, then the proxy of the newly calculated region 
(new_p) will be the proxy of the current region in RGl 

The method is illustrated using the following pseudocode : 

RG-»urgn = RG1->urgn union RG2-»urgn 
FOR i = 0 TO number of regions in RG1 DO 

diff_rgn = rg1j->rgn difference RG2-»urgn 

IF diff_rgn is non-empty THEN 

ADD to RG a new region with diff_rgn as its region description and 

rg1j->proxy as its proxy. (*) 
END IF 
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FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1j->rgn intersection rg2j->rgn 
IF inter_rgn is non-empty THEN 
IF rgli is OPAQUE THEN 
5 new_p = rg1j->proxy 

ELSE 

create new proxy new_p initialised to OVER of rg1j->proxy 
and rg2j-*proxy inside inter_rgn. 
END IF 

I o ADD to RG a new region with inter_rgn as its region description 

and new_p as its proxy. (+) 
END IF 
END DO 
END DO 

1 5 FOR j = 0 TO number of regions in RG2 DO 

diff_rgn = rg2j->rgn difference RG1->-urgn 
IF diff_rgn is non-empty THEN 

ADD to RG a new region with diff_rgn as its region description and 

rg2j->proxy as its proxy. (*) 
20 END IF 

END DO 

2.4.2 Opaque Area Optimisation for "IN" Region Groups 

If a region is "IN" an opaque region, then according to the properties of the "IN" 
25 operator, the resultant pixel data is the same as that of the left operand. This can be 
achieved by having the resultant region simply reference the proxy of the left operand. 
The method of the preferred embodiment is a slightly modified version of the "IN" region 
group construction method provided previously. The only difference is that when 
calculating the intersection region of the current region in RG1 and each region of RG2, a 
30 check is carried out to see whether the current region in RG2 is opaque. If this is the 
case, then the proxy of the newly calculated region (new_p) will be the proxy of the 

current region in RG1. 

The technique is illustrated using the following pseudocode: 
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RG->urgn = RG1-»urgn intersection RG2-*urgn 
FOR i = 0 TO number of regions in RG1 DO 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1i-ngn intersection rg2p»rgn 
5 IF inter_rgn is non-empty THEN 

IF rg2j is OPAQUE THEN 
new_p = rg1j->proxy 
ELSE 

create new proxy new_p initialised to IN of rg1j->proxy and 
10 rg2j->proxy inside inter_rgn. 

END IF 

ADD to RG a new region with inter_rgn as its region description 
and new_p as its proxy. (+) 
END IF 
15 END DO 

END DO 

2.5 Initialising the Entire Tree 

The entire compositing tree can be initialised by using the above-described method 
20 of the preferred embodiment on every binary region group in the tree. A node cannot be 
initialised until its children have been initialised. Therefore the process simply starts at 
the bottom of the tree and works its way up towards the root. The process first checks to 
see if the current node is a leaf node. If this is the case, then a leaf node region group is 
constructed. However, in the case that the current node is a binary node then a binary 
25 node region group is constructed using the method of the preferred embodiment outlined 
in sections 2.4.1 and 2.4.2. The following pseudocode outlines a method for initialising 
all the region groups of the tree. The method utilises a recursive function, which is called 
passing the root of the tree as an argument. 



30 tree_init(node : tree ptr) 
BEGIN 

IFnode is a leaf node THEN 

CONSTRUCT leaf node region group 

ELSE 

35 tree_init(node-»left) 
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and proxies) using the method described above. A further embodiment of the above 
mentioned preferred method, which supports dynamic rendering is described below. The 
compositing tree represents an image. Changes to the tree can be made to make the tree 
represent a new image. The tree's region groups (and tree region description and proxies) 

5 are updated to reflect this modified tree. Performance is improved by exploiting 
commonality between the two images. An example will illustrate the techniques and 
terminology of the further embodiment. 

Fig. 3 shows the region subdivision and the respective compositing expressions 
(advantage is not taken of opacity) for the simple compositing tree. Consider therefore 

10 the situation in which object A moves by a small amount relative to the other objects. 
Some regions in the region group at the root of the tree will be affected by A moving. 

If opaque case optimisations are ignored, the regions with compositing expressions 
which include A will be significantly affected by A moving. The region numbers which 
are so affected are 2, 3, 5 and 6. When updating the region group at the root of the tree, 

15 those regions will need both their region descriptions and their proxies completely 
recalculated. This situation is known in the further embodiment as primary damage. Any 
region whose compositing equation includes an object which has changed in some way, 
may be said to suffer primary damage. 

Regions that abut regions which have A in their compositing expression are also 

20 effected by A moving, though not as severely as those regions with primary damage. In 
the example, these other affected regions are 1, 4, 7 and 8. When updating the region 
group at the root of the tree, these regions will need their region descriptions recalculated. 
However, their proxies will only need to be recalculated in areas of the new region which 
were not included in the corresponding earlier region. This situation is known in the 

25 further embodiment as secondary damage. Generally, secondary damage is incurred if an 
object upon which a region's boundary (but not content) depends, changes in some way. 

In order to reduce the per-frame update cost, it is important to reduce, as far as is 
practicable, the amount of work necessary, both in terms of per-pixel operations, but also 
in terms of region group operations. The concepts of primary and secondary damage are 

30 a way of facilitating this. If the preferred embodiment is able to accurately determine the 
minimum set of regions throughout all the compositing tree which have some kind of 
damage, then obviously the amount of work being done is reduced. The following 
sections describe how the reduction in work done is achieved. 
3.1 Basic Data Model 

35 The data model used for static rendering, consisting as it does of a region 
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to create a new contents label that represents the symbolic expression that represents the 
combination of the contributing expressions. For example, if the contents label 
representing ((A comp B) comp C) is combined with the contents label representing (D 
comp E) then a new contents label will be created which represents (((A comp B) comp 

5 C) comp (D comp E)). 

As well as contents labels, dependency information is also required. Dependency 
information indicates how a given contents label is related to other contents labels, both 
in terms of how the contents of one region contribute to contents of other regions, and 
how change of a region boundary affect the boundary of other regions. The further 

1 0 embodiment associates the following data with each contents label. 

(i) Primary Dependency List: Each primary dependency is a contents label L' to 
which a contents label L directly contributes. In other words, a "primary dependency" is 
a contents label L' representing an expression which has been constructed by combining L 
and some other contents label. Each time contents labels are combined, the contents label 

1 5 lor the combination is added to the primary dependencies of all contributors. 

(ii) Secondary Dependency List: Each secondary dependency is a contents label 
L" which can be indirectly affected if the image represented by the contents label L has 
changed in some way that affects it's boundary. Whenever contents labels are combined, 
a contributing contents label is added to the secondary steps of the continuation if and 

20 only if the compositing operator yields a difference region with said contributing contents 
label. Table 2 shows which of some commonly used operators yield difference regions 
for their left and right operands. In addition, for a combination of (A comp B), the 
secondary dependencies of the combination contents labels for all (A comp bi) and all (aj 
comp B) are added, where aj are the secondary dependencies of A and b, are the 

2 5 secondary dependencies of B . 

(iii) Property Information: Each contents label can represent contents which have 
properties which the compositing engine may be able to exploit. An example is that of 
opaqueness. If a contents label represents opaque content, then compositing that content 
could be much faster, as for certain operators, no per-pixel compositing operations would 

30 be required. 

3.3 Contents Label Implementation 

The further embodiment uses unique integers as contents labels, and stores a 
number representing the number of contents labels which currently exist. When a new 
contents label is created, the number is incremented and becomes the unique, integer 

35 representing the contents label. This technique of assigning a contents label by 
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monotonically incrementing an integer means that the contents labels' associated data 
structures can be stored in a one dimensional array which grows as more contents labels 
are added. A content label's data structure can be referenced simply by using the 
contents label as an index. When a leaf node contents label is created, the contents label 
is initialised to have no primary or secondary dependencies. If the current leaf node 
contents label is opaque, then a flag is set in content label i*s properties. 

The pseudocode below illustrates the basic techniques used to create a new contents 
label which is not dependent on other contents labels (ie: a leaf node region group 
contents label): 



Notation 



opaque 


A flag passed to the function which indicates whether or not 


the contents label represents opaque content or not. 


cur_clab 


A global integer which stores the last contents label created. 


clabs 


A global array which stores the associated data structures of 




the contents label. 


ciabs[i]->pri_deps 


A pointer to the head of content label i's primary 


dependency list. 


clabs[i]->sec_deps 


A pointer to the head of content label i's secondary 


dependency list. 


clabs[i]->properties 


A flag register representing contents label i's properties. 



create_new_contents_label 

( 

opaque : boolean 
) : RETURNS unsigned int 
BEGIN 

INCREMENT cur_clab. 

clabs[cur_clab]-»pri_deps = NULL 

clabs[cur_clab]-»sec_deps = NULL. 

IF opaque THEN 

clabs[cur_clab]-*properties = OPAQUE. 

ELSE 

clabs[cur_clab]-*properties = 0. 
END IF 

RETURN cur_clab. 
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END create_new_contents_label. 

Contents labels can also be created to represent the combination of existing contents 
labels. This is achieved in the further embodiment by a hash table which maps an 
operation and the contents labels of its operands (hashed together to create a key) to a 
single contents label representing the result. 

When a region is created which represents an intersection between two other 
regions (each with its own contents label), a new contents label is generated which is used 
to tag the new region. When this new contents label is generated, it must be added to the 
primary dependency lists of both its contributing operands. A secondary dependency list 
which depends on the secondary dependencies of the two contributing contents labels as 
well as the properties of the compositing operator must also be generated. 

The process is recursive and begins by adding the newly created contents label 
(new_cl) to the primary dependency lists of the contributing contents labels. Then, 
depending on the properties of the compositing operator, none, either or both of the 
contributing contents labels are added to the secondary dependency list. Then every 
contents label representing (clabl op sd2,) and (sdli op tab2) are added to the secondary 
dependency list. 



Notation 


clabl 


The first contributing contents label. 


clab2 


The second contributing contents label. 


sdli 


The i'th element of clabl's secondary dependency list. 


sd2i 


The i'th element of clab2's secondary dependency list. 



create_binary_contents_label 

( 

clabl : contents label, 
clab2 . contents label, 
op: compositing operator 

) 

BEGIN 

IF the hash table already contains an entry representing clabl op clab2 
THEN 

RETURN the existing contents label representing the combination. 
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END IF 

Generate a new entry in the hash table representing clabl op clab2, map- 
ping to new_cl. 

(Add the new contents label to the primary dependency lists of the contribut- 
ing contents labels if the compositing op requires it) 
add_to_primary_dep_list(clab1, new_cl) 
add_to_primary_depJist(clab2, new_cl) 

(Generate the secondary dependencies) 
IF op generates left diff rgns THEN 
add clabl to secondary deps 
END IF 

IF op generates right diff rgns THEN 

add clab2 to secondary deps 
END IF 

FOR i = 0 TO number of elements in sd1 DO 
add_to_secondary_dep_list 

( 

new_cl, 

create_binary_contents_label(sd 1 i, clab2) 

) 

END DO 

FOR i = 0 TO number of elements in sd2 DO 
add_to_secondary_dep_list 

( 

new_cl, 

create_binary_contents_label(clab1 ; sd2j) 

) 

END DO 

END constuct_binary_contents_label 

3.4 Combining Region Groups for Dynamic Rendering 

Before any incremental updates can be made to a compositing tree, the con 
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positing tree must be constructed to be in a consistent initial state. The basic technique 
for achieving this is the same as that used for static rendering, except that support for 
contents labels is included. 

Leaf node region groups are initialised essentially as with the static rendering case, 
except that each region in each leaf node region group is tagged with a unique contents 
label. Each contents label can in turn be tagged with various categorisation properties 
which may help the renderer to be more efficient. For example, a contents label can be 
tagged as being completely opaque. 

The initialisation of binary nodes is also similar to the static rendering case. By 
way of example, the way in which the region group for an "OVER" binary node is 
constructed will now be explained. The techniques for constructing the region groups of 
the other compositing operators can easily be inferred from the "OVER" case. 

When a difference region between rgi of one operand and the coverage region of the 
other operand is calculated, the difference region inherits the contents label rgi. When an 
intersection region is created, on the other hand, a new contents label is created by 
combining the contents labels of the two contributing regions since the two contributing 
regions had their proxies composited into a new proxy which means new content. The 
pseudocode for constructing an "OVER" region group which includes contents label 
management is provided below: 



Notation 



RGI 


The region group of the binary node's left child 


RG2 


The region group of the binary node's right child 


RG 


The region group of the binary node. It is this region group 
that we are initialising 


RGl->urgn 


The region description representing the union of all RGl's 
region descriptions (RGl's coverage region). 


RG 1 ->urgn 


The region description representing the union of all RG2's 
region descriptions (RG2's coverage region). 


RG->urgn 


The union of all RG's region descriptions. 


rgli 


The current region in RGI 


rg2j 


The current region in RG2 


rgli->rgn 


rgli's region description 


rg2j-ngn 


rg2j's region description 


rgli-» proxy 


rg 1 i's proxy 
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rg2j-»proxy I rg2j's proxy 



RG-mrgn = RG1->urgn union RG2-»urgn 
FOR i = 0 TO number of regions in RG1 DO 

diff_rgn = rg1j-»rgn difference RG2->urgn 

IF diff_rgn is non-empty THEN 

ADD to RG a new region with diff_rgn as its region description, 
rg1j-»proxy as its proxy and rg1j-K:lab as its contents label. 

END IF 

FOR j = 0 TO number of regions in RG2 DO 
inter_rgn = rg1j->rgn intersection rg2j-»rgn 
IF inter_rgn is non-empty THEN 

new_clab = GENERATE a new unique contents label as a result 
of combining rg1j-»clab and rg2j-»>clab. 

IF rg1i-»clab is OPAQUE THEN 

new_p = rg1j->proxy 
ELSE 

create new proxy new_p initialised to OVER of rg1j->proxy 
and rg2j->proxy inside inter_rgn. 
END IF 

ADD to RG a new region with inter_rgn as its region description, 
new_p as its proxy and new_clab as its contents label. 
END IF 
END DO 
END DO 

FOR j = 0 TO number of regions in RG2 DO 

diff_rgn = rg2j-»rgn difference RG1-»urgn 

IF diff_rgn is non-empty THEN 

ADD to.RG a new region with diff_rgn as its region description, 
rg2j->proxy as its proxy and rg2j->clab as its contents label. 

END IF 
END DO 
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3.5 Secondary Dependencies and Over 

The rationale behind the preferred method used for generating secondary 
dependencies requires more explanation. Secondary dependencies are only generated 
when a new contents label is created by combining two other contents labels. As can be 

5 seen in the above pseudocode, this only occurs when an intersection region is generated. 
Essentially, (he further embodiment uses contents labels generated for intersection 
regions as triggers - the regions tagged with two contents labels cannot indirectly affect 
one another unless they intersect. The secondary dependency list for a particular contents 
label is dependent on the compositing operator the composite contents label represents, 

1 0 the two contributing contents labels and their secondary dependency lists. 

The method of the further embodiment of generating a secondary dependency list for 
a new contents label (C) which represents one contents label (A) composited over another 
contents label (B) using the "OVER" operator will now be explained. Elements of A's 
and B's secondary dependency lists are referred to as A and Bj respectively. First, both 

1 5 A and B are added to C's secondary dependency list. This is because if the region tagged 
with C changes its boundary, then it is likely that any regions tagged with A and B will 
need to be recalculated (because their regions are likely to abut C's region). Next, for 
each element of B's secondary dependency list, each contents labels representing (A 
OVER BO is added. A mapping representing A OVER Bi may not currently exist in the 

20 system and needs to be created. A secondary dependency list can contain contents labels 
which are not represented by any region in a region group. They could come into 
existance by changes in region boundaries. The rationale is that A intersects B, and 
therefore it is likely that A also intersects regions tagged with contents labels which exist 
in B's secondary dependency list. Similarly, for each element of A's secondary 

25 dependency list, each contents label representing (A ( OVER B) is added. 

3.6 Contents Labels and Damage 

The concepts of primary and secondary damage were introduced with reference to 
Fig. 3 to demonstrate that it is not always necessary to regenerate an entire image as a 
result of a change to the compositing tree. By keeping track of dependencies between 

30 regions of different content, it only becomes necessary to regenerate image data in 
regions whose contents have become damaged. The following explanation outlines the 
dependencies and damage for simple compositing tree changes. "Simple" means that 
only leaf nodes are modified. More complex change scenarios such as tree structure 
changes etc will be outlined in later sections. 

35 If a loaf node is modified, the contents labels of its affected regions are said to be 
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"primary damaged". Primary-damaging a contents label involves recursively primary- 
damaging all its primary dependencies. Whenever a contents label is primary-damaged, 
all its secondary dependencies are non-recursively marked with secondary damage. The 
process begins by flagging the contents label to be damaged. The following pseudocode 
demonstrates how contents labels can be damaged: 



Notation 


clab 


The contents label to be damaged 


pdi 


The i'th element of dab's primary dependency list. 


sdi 


The i'th element of clab's secondary dependency list. 



damage_contents_label 

( 

clab : contents label, 

) 

BEGIN 

FLAG clab with PRIMARY damage 

FOR i = 0 TO number of elements in sd DO 
FLAG sdj with SECONDARY damage 
END DO 

FOR i = 0 TO number of elements in pd DO 
damage_contents_label(pdj) 

END DO 
END damage_contents_label 

When a tree update occurs, any region with its contents label marked as having 
primary damage will need to recalculate both its region boundaries and its proxy. Any 
region with its contents label marked as having secondary damage will need to recalculate 
its region description but will only need to recalculate its proxy in areas of the new region 
that were not included in the earlier region. 
3.7 Examples of Contents Labels and Dependencies 

In order to clarify the concepts of contents labels and damage, some examples of 
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varying complexity will be presented. 
3.7.1 Example 1 

Fig. 9 will result in the following contents label table after the compositing tree is 
initially constructed (Note: in the following table contents labels are represented as 
unique strings not as integers where "over" has been abbreviated to "o". This is simply 
for readability.): 



Contents Label 


Primary Dcps. 


Secondary Deps. 


A 


AoB 




B 


AoB 




AoB 




A, B 



If A moves, then AoB will have primary damage, resulting in B having secondary 
damage. 

3.7.2 Example 2 

Fig. 10 will result in the following contents label table after the compositing tree is 

initially constructed: 



Contents Label 


Primary Deps. 


Secondary Deps. 


A 


AoB, AoC 




B 


AoB, BoC 




AoB 


AoBoC 


A.B J 


C 


AoC, BoC, (AoB)oC 




AoC 




A,C 


BoC 




B,C 


(AoB)oC 




AoB, C, AoC, BoC 



25 



In this example, every object intersects every other object, so if something changes, 
everything will be damaged in some way - everything which is a primary dependency of 
the changed object will have primary damage, whereas everything else will have 
secondary damage. 

Fig. 1 1 illustrates the effect of A moving in a subsequent frame. As can be seen, if 
A is damaged, the regions defined by A, AoB, AoC and (AoB)oC will each have primary 
damage. The regions defined by B, C and BoC will each have secondary damage. 
3.7.3 Example 3 

Fig. 12 will result in the following contents label table after the compositing tree is 

initially constructed: 
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Concents Label 


irriinary il>c[jo. 


Secondary Dens. 


A 

A 


AnR AnP AnF AnfDoE^ 
r\UD, rVUV^, AUG, nU^UL/, 

AoD 




B 


AoB, BoC, BoE 




A A D 

AOB 


AoRnF 


A, B 


D 


DoE, AoD, CoD, (AoC)oD 




E 


rir\P AnF /AnR^nF RoF 

CoE, (BoC)oE, (AoC)oE 




DoE 


AO^UOCJ, ^AOl^JO^UOCJ, 

Co(DoE) 1 


D F 


C 


AOL, DOL, V^Ovi^OC^, v^oc, 




AoC 




A C 


DOL 


DUV^ JUL 


B, C 


AOC 




A, E 


^AOD jod 




AoB, E, AoE, BoE 


bob 




B, E 


Lob 




C,E 


(LJoL)ob 




BoC, E, BoE, CoE 


AOU 




A,D 


LOU 




C,D 


(AoC)oE 




AoC, E, AoE, CoE 


Ao(DoE) 




A, DoE, AoD, AoE 


Co(DoE) 




C DoE CoD CoE 






AoC, DoE, Ao(DoE), 
Co(DoE), (AoC)oD, 
(AoC)oE 


(AoC)oD 




AoC, D, AoD, CoD 



o o o 
o a o 
o o o 

Since A intersects every other object, if A moves, a large amount of the 
compositing tree will need to be recomputed. Fig. 13 shows that the only part left alone 
is the area corresponding to BoC and its dependent BoCoE. To summarise: 

5 oPrimary Damage - A, AoB, AoC, AoE, Ao(DoE), (AoB)oE, (AoC)oE, 

(AoC)o(DoE), AoD, (AoC)oD 
oSecondary Damage - B, C E, DoE, BoE, CoE, DoE, CoDoE 
On the other hand, if B moves, the amount of damage is less than if A moved. This 
is because B doesn't intersect D. DoE, Ao(DoE), (AoC)o(DoE), Co(DoE) and (AoC)oE 
10 (and their ancestors) are not damaged when B moves. This is shown in Fig. 14. The rest 
of the damage is summarised as: 

oPrimary Damage - B, AoB, BoC, BoE, (AoB)oE, (BoC)oE 

oSecondary Damage - A, E, C, AoE, CoE 
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The examples presented so far are simple, but they are sufficient to demonstrate that 
the dependencies techniques presented so far will damage those contents labels which are 
affected when a particular contents label/s is(are) damaged. In a typical complex 
composite, it is rare for large numbers of objects to intersect a large number of other 
5 objects, meaning that large areas of the compositing tree should be untouched during 
updates using the above technique. 

3.8 Example of Secondary Dependencies and Compositing Operators 

Consider a modified version of Example 3 above. Fig. 1 8 will result in the 
following contents label table after the compositing tree is initially constructed. Note that 
1 0 AaB represents A ATOP B and AiB represents A IN B etc: 



• • • 


Contents Label 


Primary Deps 


Secondary Deps 


• • • 

• t 


A 


AaB 




• • • • 

• • • 

• • 


B 


AaB, BoC 




• • • • • 
• 


AaB 




B 


• 

• • • • 


c J 


BoC, Co(DiE) 




• • • • 


BoC 




B,C 


• • • • 


D 


DiE 




• • • 
• • • 


E 


DiE 




* • • • 
• • • 
mm • 


DiE 


Co(DiE) 






Co(DiE) 




C, DiE 



As seen in Fig. 18, the ATOP operator clips A to B's bounds, meaning that 
intersections between A and any of C, D or E never occur. Similar things occur with the 

1 5 IN operator. This means that the objects in this scene are Jess tightly coupled. For 
example, if A is changed, then only B and AaB are immediately damaged. Similarly, if E 
is damaged, it is only possible for DiE to be damaged. 
3.9 Updating Region Groups 

The further embodiment uses the contents label and damage framework to reduce 

20 the amount of work that has to be done to make a binary region group consistent with its 
updated operands during an update. The further embodiment does this by only updating 
those regions in a region group whose contents labels have primary or secondary damage, 
adding any new region which comes into existence as a result of the changes made to the 
compositing tree, and deleting any region in the right group whose contact no longer 

25 exists. 

Each different binary operator has a different updating function which deals with 
the specific requirement of that operator. The process of updating region groups is a two- 
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pass process. The first pass updates any intersection regions that have been primary 
damaged and adds any new intersection regions generated due to the damage. Each 
region of one operand's region group is intersected with each region of the other operand's 
region group whenever one or both of their corresponding contents labels are primary 

5 damaged. If the intersection is non-empty, then the further embodiment determines if a 
contents label representing the combination exists. If the contents label doesn't exist, one 
is created and primary damaged. Note that primary damaging a contents label will mark 
all it's secondary dependencies with secondary damage. 

If a region in the region group is currently tagged with the primary damage contents 

1 0 label, the regions boundary and proxy are updated. If no such region exists in this region 
group, then a new region keyed by this contents label is added to the region group. A 
new proxy is generated and assigned to this region along with the right description 
relating from the intersection operation. 

A difference between each region group of one operand and the coverage region of 

15 the other operand is calculated whenever the regions contents label has primary or 
secondary damage. If the difference is non-empty and a region tagged with the contents 
label exists in the region group, then it's region description and proxy reference are 
updated. If such a region doesn't exist then a region keyed by the contents label is added 
to the region group. The added region is assigned as a coverage region of the difference 

20 result and references the proxy of current region. 

Each region of one operand's region group is interacted with each region of the 
other operand's region group whenever the contents label representing their combination 
has secondary damage and no primary damage. If the intersection is non-empty, the 
region group is searched looking for a region keyed by the contents label. If such a 

25 region exists its region description is updated and it's proxy is updated as the difference 
between the new and old regions. If such a region doesn't exist, then a region keyed by 
the contents label is created. The created region description is assigned the result of the 
interaction operation and it's proxy generated. 

Pseudocode which illustrates a simple algorithm for updating a binary "OVER" 

30 region group is provided below. 



Notation 

RGI I The region group of the binary node's left child 
RG2 The region group of the binary node's right child 
RG The region group of the binary node. It is this region group 
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that is being initialised. 


RGl-»urgn 


The region description representing the union of all RGl's 
region descriptions (RGl's coverage region). 


RGI-»urgn 


The region description representing the union of all RG2's 
region oescnpuons b covci<tgc ic^iuu;. 


RG-»urgn 


I ne union or an s regiuu ucaciipuuna. 


rgli 


1 ne current region in ivvj i 


ro?i 


The current region in RG2 

g. 1 vUl 1 will I VLlUll ■ *— 


rtw 1 l *k t*f T 11 

rgi l— »rgn 


reli's reeion description 


rgzj->rgn 


rir9i*Q renion description 


rgli-»proxy 


rg 1 1 s proxy 


rg2j->proxy 


rg2j's proxy 


rgli— >clab 


rgl i's contents label 


rg2j-»clab 


rg2j's contents label 



RG-^urgn = RG1-»urgn union RG2-»urgn 

(First Pass - this pass is used to deal with primary damage of intersection regions 

and any new intersection regions generated) 
FOR i = 0 TO number of regions in RG1 DO 

FOR j = 0 TO number of regions in RG2 DO 

IF rg1j->clab has PRIMARY damage OR rg2j->clab has PRIMARY 

DAMAGE THEN 

inter_rgn = rg1i->rgn intersection rg2j-+rgn 

IF inter_rgn is non-empty THEN 

comp_clab = SEARCH for an existing contents label which 
represents (rg1j-»clab comp rg2j->clab). 

IF a region tagged with comp_clab already exists in RG 

THEN 

IF rg1i->clab is OPAQUE THEN 

new_p = rg1i-»proxy 
ELSE 

create new proxy new_p initialised to OVER of 
rg1i-»proxy and rg2j-»proxy inside inter_rgn. 



• • • 
• 



10 



15 



20 
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END IF 

MODIFY the existing region to have inter_rgn as its 
region description and new_p as its proxy. 

ELSE 

new_clab = create_binary_contents_label(rg1j->clab, 

rg2j-»clab). 

IF rg1i->clab is OPAQUE THEN 

new_p = rg1i-»proxy 
ELSE 

create new proxy new_p initialised to OVER of 
rglj-»proxy and rg2j-»proxy inside inter_rgn. 

END IF 

. damage_contents_label(new_clab) 
ADD to RG a new region with inter_rgn as its region 
description, new_p as its proxy and new_clab as its contents label. (+) 

END IF 

FLAG the region as being 'RETAIN AFTER UPDATE" 
END IF 
END IF 
END DO 
END DO 

(Second Pass - this pass is used to deal with primary and secondary damage of 
difference regions and secondary damage of intersection regions) 
FOR i = 0 TO number of regions in RG1 DO 

IF rg1j-»clab has PRIMARY or SECONDARY damage THEN 
diff_rgn = rg1i->-rgn difference RG2-»urgn 
IF diff_rgn is non-empty THEN 

IF a region tagged with rg1j->clab already exists in RG THEN 
MODIFY it to have diff_rgn as its region description and 
rg1j->proxy as its proxy. 

ELSE 

ADD to RG a new region with diff_rgn as its region descrip- 
tion, rg1i->proxy as its proxy and rg1j->>clab as its contents label. (*) 
END IF 
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FLAG the region as being 'RETAIN AFTER UPDATE' 
END IF 
END IF 

FOR j = 0 TO number of regions in RG2 DO 

comp_clab = SEARCH for an existing contents label which represents 
(rg1i->clab comp rg2j->clab). 

IF comp_clab exists AND comp_clab has SECONDARY damage but 

NO PRIMARY damage THEN 

inter_rgn = rg1j->rgn intersection rg2j->rgn 

IF inter_rgn is non-empty THEN 

GET a reference to the existing region tagged in this region 
group with comp_clab which MUST exist in this region group 

IF rg1j->clab is OPAQUE THEN 

existing regions proxy =rglj -»proxy 
ELSE 

update_rgn = inter_rgn difference the region's previous 

region description. 

update existing regions proxy to include OVER of 
rgli-»proxy and rg2j -> proxy inside update region. 

END IF 

MODIFY the existing region to have inter_rgn as its region 

description and new_p as its proxy. 

FLAG the region as being 'RETAIN AFTER UPDATE' 

END IF 
END IF 
END DO 
END DO 

FOR j= 0 TO number of regions in RG2 DO 

IF rg2j->clab has PRIMARY or SECONDARY damage THEN 
diff_rgn = rg2j->rgn difference RG1-+urgn 
IF diff_rgn is non-empty THEN 

IF a region tagged with rg2j-»clab already exists in RG THEN 
MODIFY it to have diffjrgn as its region description and 
rg2j-+proxy as its proxy. 
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ELSE 

ADD to RG a new region with diffjrgn as its region 
description, rg2j-»proxy as its proxy and rg2j-»clab as its contents 

label. (*) 

END IF 

FLAG the region as being 'RETAIN AFTER UPDATE* 
END IF 
END IF 
END DO 

DELETE all regions of RG which are not marked RETAIN AFTER UPDATE but 
whose contents labels have damage, and CLEAR flag in retained regions. 



i ••• 
• « 
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4.0 Tree Modifications (Linking and Unlinking) 

1 5 More complex changes lo a compositing tree can be achieved by changing the tree's 

structure. Most typical tree structure changes can be made by using two low level 
operations, link and unlink. 

The unlink operation is used to separate a child node from its parent. After the 
operation is completed, the child node has no parent (meaning the child node can be 

20 linked in somewhere else), and the parent has a link available (meaning that some other 
node can be linked there instead). Nodes in the compositing tree above the unlinked child 
contain content which is dependent on the unlinked child. Therefore, at the time of the 
next update, the contents label present in the unlinked child at the time of unlinking must 
be damaged to ensure that the dependent region groups higher in the tree are 

25 appropriately updated. The updating is achieved by the parent node caching away those 
contents label existing in its unlinked child. If another subtree is linked in its place and 
subsequently unlinked without the region group of the parent being updated, it is not 
necessary to cache the contents labels of this new subtree. Pseudocode for the unlink 
operation is provided below. Note that the UNLINKED LEFT or UNLINKED_R1GHT 

30 flag is set so that the contents labels of a newly linked subtree may be damaged when 
region groups (including their proxies) higher in the tree must then be updated. 



unlink 
( 

35 node : compositing tree node 
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) 

BEGIN 

parent = node -^parent, 
node -^parent = NULL. 
IF node is parent's left child THEN 
parent -»left = NULL. 

IF parent doesn't have UNLINKED_LEFT set THEN 
SET the UNLINKED LEFT flag in parent. 

ELSE. 

RETURN. 
END IF 

ELSE IF node is parent's right child THEN 
parent -bright = NULL. 

IF parent doesn't have UNLINKED_RIGHT set THEN 
SET the UNLINKED_RIGHT flat in parent. 

ELSE 

RETURN 
END IF 
END IF 

COPY all the contents labels in node's region group into an array stored in 
parent ->unlinked_clabs. 
END unlink 

The link operation involves linking a node with no parent to a free link of a parent 
node. Pseudocode for the operation is provided below: 

link 
( 

child : compositing tree node, 
parent . compositing tree node, 
whichjink : either LEFT or RIGHT 

) 

BEGIN 

child -^parent = parent 

IF which link is LEFT THEN 



inn r/vi«o»w»nnKiwnMVn SCRNIII 147 I440.c]i>c:IAD 



-44- 



parent — »left = child. 
ELSE 

parent -> right = child. 
END IF 
5 END LINK 

4.1 Updating the Entire Compositing Tree 

If a leaf node in the compositing tree changes, the region group of every node in a 
direct line from the leaf node to the root of tree must be updated using the methods 
10 described above. Fig. 15 shows circled those nodes which need to have their region 
groups updated if leaf nodes B and H change in some way. 

Pseudocode for the tree updating method is provided below: 

update_tree 
15 ( 

node : compositing tree node 

) 

BEGIN 

IF node is leaf node THEN 
20 Rerender the leaf node and update its region group. 

ELSE 

IF unlinking occurred in left subtree or left subtree contains dirty leaf 
nodes THEN 

update_tree(node -»left). 
25 END IF. 

IF unlinking occurred in right subtree or right subtree contains dirty leaf 
nodes THEN 

update_tree(node -bright). 
END IF. 

30 IF node has UNLINKED_LEFT or UNLINKED_RIGHT flags set THEN 

CALL damage_contents_label on every element of 
node-»unlinked_clabs. 

IF node has UNLINKED_LEFT set THEN 

CALL damage_contents_label on every contents label exist- 
35 ing in node-cleft's region group. 
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CLEAR the UNLINKEDJ.EFT flag in node. 
END IF 

IF node has UNLINKED_RIGHT set THEN 

CALL damage_contents_label on every contents label exist- 
5 ing in node-Wright's region group. 

CLEAR the UNLINKED_RIGHT flag in node. 
END IF 
END IF 

CALL the region group update routine appropriate for node's composit- 
10 ing operator. 

END IF 
END updatejree 



The embodiments of the invention can be implemented using a conventional 

15 general-purpose computer system 2100, such as that shown in Fig. 19, wherein the 
process described with reference to Fig. 1 to Fig. 18 are implemented as software 
recorded on a computer readable medium that can be loaded into and carried out by the 
computer. The computer system 2100 includes a computer module 2101, input devices 
2 1 02, 2 1 03 and a display device 2 1 04. 

20 With reference to Fig 19, the computer module 2101 includes at least one processor 

unit 2105, a memory unit 2106 which typically includes random access memory (RAM) 
and read only memory (ROM), input/output (I/O) interfaces including a video interface 
2107, keyboard 2118 and mouse 2120 interface 2108 and an I/O interface 21 10. The 
storage device 2109 can include one or more of the following devices: a floppy disk, a 

25 hard disk drive, a CD-ROM drive or similar a non-volatile storage device known to those 
skilled in the art. The components 2105 to 21 10 of the computer module 2101, typically 
communicate via an interconnected bus 21 14 and in a manner which results in a usual 
mode of operation of the computer system 2100 known to those in the relevant art. 
Examples of computer systems on which the embodiments can be practised include IBM- 

30 PC/ ATs and compatibles, Sun Sparcstations or alike computer system. In particular, the 
pseudocode described herein can be programmed into any appropriate language and 
stored for example on the HDD and executed in the RAM 2106 under control of the 
processor 2105 with the results being stored in RAM within the video interface 2107 and 
reproduced on the display 21 16. The programs may be supplied to the system 2100 on a 

35 pre-programmed floppy disk or CD-ROM or accessed via a connection with a computer 
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network, such as the Internet. 

The aforementioned preferred method(s) comprise a particular control flow. There 
are many other variants of the preferred method(s) which use different control flows 
without departing the spirit or scope of the invention. Furthermore one or more of the 
5 steps of the preferred method(s) may be performed in parallel rather sequential. 

The foregoing describes only several embodimens of the present invention, and 
modifications, obvious to those skilled in the art, can be made thereto without departing 
from the scope of the present invention. 

In the context of this specification, the word "comprising" means "including 
10 principally but not necessarily solely" or "having" or "including" and not "consisting only 
of. Variations of the word comprising, such as "comprise" and "comprises" have 
corresponding meanings. 



• • 
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/* 

* region.cpp 
* 

* The implement ion of the region manipulation functionality in 

* the Screen OpenPage prototype. 



# include "protos.h" 

static int union_tot = 0; 
static int int_tot = 0; 
static int diff_tot = 0; 
static int union_full = 0; 
static int int_full = 0; 
static int dif f_full = 0; 

/• 

* Some tfdefs which are used to control the optimisations used in the region 

* builder implementation. . 
*/ 

ttdefine R_USE_NEW_IMP 

#define RB_FAST_SHI FT_AND_DUP_LOOPS 

Udefine RB_USE_LOOKUP 

ttdefine R NEW IMP CONSTRUCT 1 0N_LOOP 



The global variables used to store the temporary results needed during 
region manipulation operations. Two statically allocated 
R_RegionBuilder structures are used. This is to allow data to be 
read from one of them whilst the data required for the next operation 
is written into the other one. Two pointers r_PrevRB and R_CurRB are 
used to swap access to the two static structures. The 
r_grow_region_builder function is called to grow a R_RegionBuilder 
structure if required. 



static R_RegionBuilder 
static R_RegionBuilder 
static R_RegionBuilder 
R_RegionBuilder 



r_RBl = {0, 0, NULL, NULL} ; 
r_RB2 = {0, 0, NULL, NULL) ; 
*r_PrevRB = &r_RBl; 
*R CurRB = &r RB2; 



* r_shif t_and_dup 
# 

* A 16-byte lookup table which when provided with an unsigned char 

* of the following form xxyy, simply produces xxxx. This lookup table 

* _assumes_ that R_STATE_SIZE is 2. It _won't_ work (and will die 

* horribly) if this isn't the case. 
*/ 

unsigned char r_shif t_and_dup [16) = { 



}; 



0x00, 
0x05, 
OxOA, 
OxOF, 



0x00, 
0x05, 
OxOA, 
OxOF, 



0x00, 
0x05, 
OxOA, 
OxOF, 



0x00, 
0x05, 
OxOA, 
OxOF 



* A buffer is required to store the new region data whilst a region is 

* being constructed. This buffer is expanded when required. 
*/ 

static R_lnt *r_RgnBuf = NULL; 
static int r_RgnBufSize = 0; 

/* 

* A buffer of IntXYMinMax structures is required to store the rectangles 

* generated during R_rects_f rom_region . This buffer is expanded when 

* required. 



static IntXYMinMax *r RectBuf = NULL; 



1* 

static int 
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r RectBufSize = 0; 



* R_FREE_LIST_GROWTH_SIZE 

* This macro defines the number of elements which will be added to 

* free list whenever it is grown. 
V 

tfdefine R_FREE_LIST_GROWTH_SIZE 100 
/* 

* r_free_list 
* 

* A linked list of unused R_RgnGr owl terns which may be used during 

* region construction. 
*/ 

R_RgnGrowI tern *r_free_list = NULL; 
/* 

* r_growth_list 

* A linked list of R_RgnGrowItems which represents the current 

* state during region construction. 
*/ 

R_RgnGrowltem *r_growth_list = NULL; 
/* 

* r_grow_region_builder 
* 

* This function simply checks to see if a R_RegionBuilder structure 

* is of the required size. If it isn't the size of both 

* arrays in the R_RegionBuilder structure are doubled. 
* 

* Parameters: 

* rb The region builder to be grown. 

* size The required size of the arrays in the R_RegionBuilder . 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

static int 

r_grow_region_builder 
( 

R_RegionBuilder *rb, 
R_Int size 

) 
{ 

unsigned char *new_state_data ; 
R_Int *new_rgn_data; 
int new_size; 

new_size = max(size, rb->rrb_Size * 2) ; 

new_state_data = (unsigned char * ) malloc (new_size * sizeof (unsigned char)) 
if (new_state_data == NULL) 
return FALSE; 

new_rgn_data = (R_Int *) malloc (new_size * sizeof (R_Int) ) ,- 
if (new_rgn_data == NULL) 

{ 

f ree (new_state_data) ; 
return FALSE; 

} 

if (rb->rrb_StateData != NULL) 
{ 

memcpy 
( 

new_state_data , 
rb->rrb_StateData, 

rb->rrb_Size * sizeof (unsigned char) 

); 

f ree (rb- >rrb_StateData) ; 
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) 

if (rb->rrb_RgnData ! = NULL) 

{ 

memcpy 
( 

new_rgn_data , 

r b - > r rb_Rg nDa t a , 
rb->rrb_Size * sizeof (R_Int) 

); 

free(rb->rrb_RgnData) ; 

} 

rb->rrb_StateData = new_state_data; 
rb->rrb_RgnData = new_rgn_data ; 
rb->rrb_Size = new_size; 
return TRUE; 

} 

/* 

* r_swap_region_builders 
# 

* This function simply swaps the static pointers to the r_RBl and r_RB2 

* region builders. 
* 

* Parameters : 

* None . 

* Returns: 

* Nothing. 
V 

inline static void 

r swap_region_builders ( ) 

{" 

R_RegionBuilder *tmp; 
tmp = R_CurRB; 
R_CurRB = r_PrevRB; 
r_PrevRB = tmp; 

} 

/* 

* R_add_row_to_region_builder 
* 

* This function adds a row from a R_Region to a R_RegionBuilder structure. 

* The region from which the row comes is passed as an argument. "Adding" 

* has the following conditions... 

* * If a pixel run in the row does not exist in the region builder 

* it is added and it's current state is tagged with the region 

* to which the row belongs. The previous state is set to 0, 

* indicating that it did not exist before. 

* * If a pixel run in the row did exist before, but it's present state 

* indicates that it came from the other region then the run 

* is retained but it's state is modified to indicate that 

* both regions are active at this point. 

* * If a pixel run in the row did exist before, and it's present 

* state indicates that the current region then the region is 

* removed and it's state is modified to indicate that the run is 

* now empty. 

* * If a pixel run in the row did exist before, and it's present state 

* indicates that both regions are currently active then the run 



* is retained, but its state is modified to indicate that only the 

* other region is active in this run. 
* 

* Parameters: 

* row_ptr A R_Int ** pointer to the row in the region. Used 

* to return the updates row pointer. 

* rgn_mask A mask for the region the row comes from. Must 

* be either 1 or 2 . 

* first Whether this is the first region to be processed 

* on the current scanline. 

* Returns: 
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* TRUE on success, FALSE on failure. 

*/ 
#if 1 
int 

R_add_row_to_region_bu i lder 
( 

R_Int **row_ptr, 

int rgn_mask, 

int first 



R_Int *row; 

int src_index; 

int dest_index; 

R_I nt rb_-run_s tart ; 

unsigned char rb_j>rev_run_state; 

int row_on; 

ASSERT (rgn_mask == 1 | | rgn_mask == 2); 

row = *row_ptr; 
r_swap_region builders (); 
/* 

* Skip over the row's y value at the beginning. 
*/ 

ASSERT (* row == R_NEXT_IS_Y) ; 
row += 2; 

ASSERT (*row != R_NEXT_IS_Y && *row != R_EOR) ; 

if (r_PrevRB->rrb Nels 0) 
{ 

/* 

* If the current region builder's src region data array is empty, then 

* we are dealing with an empty region builder. We simply convert 

* the input row to the region builder format. 
V 

row_on s TRUE; 
dest_index = 0; 

whi 1 e { R_NOT_END_OF_ROW ( * row ) ) 
{ 

if (++dest_index > R_CurRB->rrb Size) 

{ 

if { ! r_grow_region_builder (R_CurRB, destindex) ) 
return FALSE ; 

) 

R_CurRB->rrb_RgnData [dest_index - 1] = *row; 
if (row_on) 

R_CurRB->rrb_StateData [dest_index - 1] = 

(rgn_mask « RB_STATE_SIZE) ; 

else 

R_CurRB->rrb_StateData[dest_index - 1] =0; 
row_on = !row_on; 
row++; 

) 

*row_ptr = row; 

R_CurRB- >rrb_Nels = dest_index; 
return TRUE; 

} 

/* 

* Firstly, we copy any runs from the region builder which 

* precede this run from the region. We are checking the 

* starting row against the start of each pixel run. Therefore 

* we start checking against the lnd region builder data 

* element . 
*/ 

ASSERT (r_PrevRB->rrb_Nels >= 2) ; 
src_index = 0; 

while (src_index < r_PrevRB- >rrb_Nels && *row > r_PrevRB- >rrb_RgnData tsrc_index) ) 
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src_index++; 
dest_index = s rc_ind ex; 
if (src index > 0) 

{ 

if (src index > R CurRB->rrb Si2e) 
{ • " 

if ( ! r_grow_region_builder (R_CurRB, src_index) ) 
return FALSE; 

} 

memcpy 
( 

R_CurRB- >rrb_RgnData , 

r_PrevRB- >rrb_RgnData , 

src_index * sizeof (R_Int ) 
); - 
if {'first) 
{ 

memcpy 
( 

R_CurRB - > r rb_S tat eDa t a , 
r_PrevRB- >rrb_StateData, 
src_index * sizeof (unsigned char) 

); 

} 

else 

{ 

int i = 0; 

unsigned char *src; 
unsigned char *dest;- 

src = r_PrevRB->rrb_StateData + src_index; 
dest = R_CurRB->rrb_StateData + src_index; 
switch (src_index) 
{ 

default: 

for (i = src_index; i > 10; i--) 
{ 

#ifndef RB_USE_LOOKUP 

Mdest - i) = (*(src - i) & RB_CUR_S T AT E_MAS K ) 
(Msrc - i) >> RB_STATE_SIZE) ; 

ttelse 

Mdest - i) = r_shift_and_dup(Msrc - i)l; 

tfendif 

} 

/* FALLTHROUGH ! ! */ 
case 10: 
#ifndef RB_USE_L00KUP 

Mdest - 10) = (Msrc - 10) & RB_CUR_STATE_MASK) | 
(*(src - 10) >> RB_STATE_SIZE) ; 

tfelse 

*(dest - 10) = r_shift_and_dup(Msrc - 10)); 

ttendif 

/* FALLTHROUGH! ! */ 
case 9: 
tfifndef RBJJSE_LOOKUP 

Mdest - 9) = (Msrc - 9) & RB_CUR_S TATE_MAS K ) | 
(Msrc - 9) >> RB_STATE_SIZE) ; 

tfelse 

Mdest - 9) = r_shif t_and_dup[* (src - 9) } ; 

ttendif 

/* FALLTHROUGH! ! */ 
case 8: 

tfifndef RB_USE_LOOKUP Mdest - 8) = (Msrc - 8) & RB_CUR_STATE_MASK) | 

(*(src - 8) » RB STATE_SIZE) ; 

tfelse 

*(dest - 8) = r_shif t_and_dup[* (src - 8)); 

#endif 
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/* FALLTHROUGHI ! */ 
case 7: 
tfifndef RB_USE LOOKUP 

Mdest - 7) = (Msrc - 7) & RB_CUR_STATE_MAS K ) | 
(Msrc - 7) >> RB_STATE_SIZE) ; 

ftelse 

Mdest - 7) = r_shif t_and_dup[* (src - 7) ) ; 

ttendif 

/* FALLTHROUGHI ! */ 
case 6: 
ffifndef R_USE_LOOKUP 

Mdest - 6) = (Msrc - 6) & RB_CUR_STATE_MASK) | 
(Msrc - 6) >> RB_STATE_SIZE) ; 

#else 

Mdest - 6) = r_shif t_and_dup[* (src - 6)]; 

ffendif 

/* FALLTHROUGHI ! */ 
case 5: 
tfifndef RB_USE_LOOKUP 

Mdest - 5) = (Msrc - 5) & RB_CUR_STATE_MASK) | 
(*{src - 5) >> RB_STATE_SIZE) ; 

#else 

Mdest - 5) « r_shif t_and_dup[* (src - 5)]; 

ttendif 

/* FALLTHROUGHI ! */ 
case 4: 
tfifndef RB_USE_LOOKUP 

*(dest - 4) = (Msrc - 4) & RB_CUR_S TATE_MAS K ) | 
(*(src - 4) >> RB_STATE_SIZE) ; 

#else 

Mdest - 4) = r_shif t_and_dup(* (src - 4)]; 

#endif 

/* FALLTHROUGHI ! */ 
case 3: 
#ifndef RB_USE_LO0KUP 

Mdest - 3) = (Msrc - 3) & RB_CUR_STATE_MASK) | 
(*(src - 3) >> RB_STATE_SIZE) ; 

ttelse 

*(dest - 3) = r_shif t_and_dup[Msrc - 3)]; 

flendif 

/* FALLTHROUGHI ! */ 
case 2: 
ttifndef RB_USE_LOOKUP 

Mdest - 2) ■ (Msrc - 2) & RB_CUR_STATE_MASK) | 
(*(src - 2) >> RB_STATE_SIZE) ; 

#else 

Mdest - 2) = r_shif t_and_dup[* (src - 2)); 

#endif 

/* FALLTHROUGHI I */ 
case 1: 
tfifndef RB_USE_LOOKUP 

Mdest - 1) = (*(src - 1) & RB_CUR_STATE_MASK) | 
(Msrc - 1) » RB STATE SIZE) ; 



tfelse 
tfendif 



Mdest - 1) = r_shif t_and_dup [Msrc - 1)); 
/* FALLTHROUGHI ! */ 

case 0: 



/* FALLTHROUGHI ! */ 

} ' 

} 

} 

if (src_index == r_PrevRB->rrb_Nels) 
{ 

/* 

* We've already exhausted the previous region builder. Set the sta 

* of the next pixel run to be the max. possible and set the state 
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* to be 0. 
*/ 

rb_run_start = R_INT_MAX_VALUE - 2; 
rb_prev_run_state = 0; 

) 

else 
( 

/* 

* We are still within the previous region builder bounds. Set up 

* the run info appropriately. 
*/ 

rb_run_start « r_PrevRB->rrb_RgnData lsrc_index] ; 
if (src_index 0) 

rb_prev_run_state = 0; 

else 

rb_prev_run_state = r_PrevRB- >rrb_StateData (src_index - 11; 

} 

* We can now start dealing with the elements in the row. 
V 

row_on = 1; 

while (R_NOT_END_OF_ROW ( *row) ) 
if (*row < rb_run_start) 

' if (dest_index + 1 > R_CurRB- >rrb_Size) 

if ( !r_grow_region_builder(R_CurRB, dest_index + 1)) 
return FALSE; 

R_CurRB->rrb_RgnData[dest_indexl = *row; 

if (first) 

{ 

/* 

* We are processing the first region. Therefore, we 

* copy the current state of the run to the lowest 

* RB_STATE_SIZE bits. 
*/ 

R CurRB->rrb StateData [dest_index] = 

(rb _prev_run_state & RB_CUR_STATE_MASK) | 
(rb_prev_run_state >> RB_STATE_S I ZE ) ; 

} 

else 
{ 

/* 

* We are processing the second region. Therefore, the state data 

* has already been copied to the previous state area so we 

* just copy the state. 
*/ 

R_CurRB->rrb_StateData[dest_index] = rb_prev_run_state ; 

} 

/* . 

* Now, if the row for the current region is active at this transition, 

* we xor the region mask with the current contents of the new region 

* builder slot. This gives the desired behaviour of making that region 

* active if it is not there already, but turns it off if it is... 
*/ 

if (row on) n 

R_CurRB->rrb_StateData(dest_index] = (rgn_mask « RB_STATE_SIZE) ; 

dest_index++; 

/* 

* We now move onto the next row element. 

*/ 
row++; 

row_on = ! row_on ; 
continue; 
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/* 

* If the current row transition point is equal in x position to the current 

* previous region builder transition point, we advance the row counter to 

* the next position. 
V 

if (*row == rb_run_start) 

{ 

row++; 

row_on = I row_on ; 

} 

/* 

* Output the previous regions builders transition region. We do similiar 

* things as for the region transition stuff above.. Firstly though, we 

* advance the rb_prev_run_state variable to the next element. We know 

* we can do this because if we were on the last element, we wouldn't 

* have hit this section of code. 
V 

rb_prev_run_state = r_PrevRB->rrb_StateData tsrc_index] ; 
if (dest_index + 1 > R_CurRB->rrb_Size) 

{ 

if ( ! r_grow_region_builder (R_CurRB, dest_index + 1)) 
return FALSE; 

) 

R_CurRB->rrb_RgnData (dest_index) = rb_run_start ; 

if (first) 

{ 

R_CurRB->rrb_StateData[dest_index] = (rb_prev_run_state & 

RB_CUR_STATE_MASK) | 
rb_prev_run_state >> RB_STATE_SIZE) ; 

} 

else 

{ 

R_CurRB->rrb_StateData[dest_index] = rbjprev_run_state; 

} 

if ( ! row_on) 

R_CurRB->rrb_StateData[dest_index] "= (rgn_mask « RB_STATE_SIZE) ; 
dest_index++; 
/* 

* We've output the previous region builder's transitions. We now move 

* over onto the next transition. If the previous src_index increment 

* has moved us onto the last element, we declare that we have run 

* out of previous region builder data. 
*/ 

ASSERT (rb_run_s tart != R_EOR) ; 

if (++src_index >= r_PrevRB- >rrb_Nels) 

{ 

/* 

* We've run out of data.. 
*/ 

rb_run_start = R_INT_MAX_VALUE - 2; 
continue; 

) 

/* 

* Otherwise, we still have stuff left to do, so we move onto 

* the next run in the previous region builder. 
*/ 

rb_run_start = r_PrevRB->rrb_RgnData (src_index] ; 



* Now, we simply blast out any remaining region builder transition 

* points. 
*/ 

f (r_PrevRB->rrb_Nels - src_index > 0) 
R_Int nels_to_copy ; 

nels_to_copy = r_PrevRB->rrb_Nels - src_index; 

if (dest_index + nels_to_copy > R_CurRB- >rrb_Size) 

{ 
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if (!rjgrow_regionJ)uilder(R_CurRB, dest^index + nels_to_copy) ) 
return FALSE; 



meracpy 
( 

R_CurRB->rrb_RgnData + dest_index, 
r_PrevRB->rrb_RgnData + src_index, 
nels_to_copy * sizeof (R_Int) 

); 

if (Ifirst) 
{ 

memcpy 
( 

R_CurRB->rrb_StateData + dest_index, 
r_PrevRB->rrb_StateData + src_index, 
nels_to copy * sizeof (unsigned char) 

); 

dest_index += nels_to_copy ; 

} 

else 
{ 

int i = 0; 

unsigned char ♦src; 
unsigned char *dest; 

i = r_PrevRB->rrb_Nels - src_index; 

src = r_PrevRB->rrb_StateData + r_PrevRB- >rrb_Nels; 

dest_index += i; 

dest = R_CurRB->rrb_StateData + dest_index; 

switch <i) 

{ 

default: 

for (; i > 10; i--) 

{ 

#ifndef RB USE LOOKUP _ % 

~ " Mdest - i) = C(src - i) & RB_CUR_STATE_MASK) | 

(♦(src - i) » RB_STATE_S I ZE ) ; 

ttelse 

♦(dest - i) = r_shift_and_dup(Msrc - i) J ; 

#endif 

/♦ FALLTHROUGH! ! ♦/ 
case 10: 

ttifndef RB USE LOOKUP % . 

*(dest - 10) = (Msrc - 10) & RB_CUR_S TAT E_MAS K ) | 
(♦(src - 10) >> RB_STATE_SIZE) ; 

ttelse 

♦(dest - 10) = r_shif t_and_dup [* (src - 10) J; 

ttendif 

/* FALLTHROUGH! ! ♦/ 
case 9: 
flifndef RB USE LOOKUP 

♦(dest - 9) = (♦(src - 9) & RB_CUR_STATE_MAS K ) | 
(♦(src - 9) >> RB_STATE_SIZE) ; 

ttelse 

♦(dest - 9) = r_shif t_and_dup [* (src - 9)J; 

Hendif 

/♦ FALLTHROUGH! ! */ 
case 8: 

tfifndef RB USE LOOKUP t , 

♦(dest - 8) - (♦(src - 8) & RB_CUR_STATE_MASK) | 
(♦(src - 8) >> RB_STATE_SIZE) ; 

#else 

♦(dest - 8) = r_shif t_and_dup[* (src - 8)1; 

ttendif 

/♦ FALLTHROUGH! I ♦/ 
case 7: 
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tfifndef RB_USE LOOKUP 

Mdest - 7) = (*(src - 7) & RB_CUR_STATE_MASK) | 
(*(src - 7) >> RB_STATE_SIZE) ; 

#else 

*{dest - 7) = r_shif t_and_dup[* (src - 7)); 

#endif 

/* FALLTHROUGH! ! */ 
case 6: 
tfifndef RB_USE_LOOKUP 

Mdest - 6) = (Msrc - 6) & RB_CUR_STATE_MASK) | 
{Msrc - 6) » RB_STATE_SIZE) ; 

ttelse 

Mdest - 6) = r_shift_and_duptMsrc - 6)]; 

ttendif 

/♦ ^FALLTHROUGH! ! */ 
case 5: 
tfifndef RB_USE_LOOKUP 

Mdest - 5) = (Msrc - 5) & RB_CUR_STATE_MASK) | 
(Msrc - 5) >> RB_STATE_SIZE) ; 

#else 

Mdest - 5) = r_shift_and_dup(Msrc - 5)]; 

tfendif 

/* FALLTHROUGH ! ! */ 
case 4 : 
#ifndef RB_USE_LOOKUP 

Mdest - 4) = (Msrc - 4) & RB_CUR_STATE_MASK) | 
(*(src - 4) >> RB_STATE_SIZE) ; 

#else 

Mdest - 4) = r_shif t_and_dup(* {src - 4)J; 

#endif 

/* FALLTHROUGH! ! */ 
case 3 : 
tfifndef RB_USE_LOOKUP 

Mdest - 3) = (Msrc - 3) & RB_CUR_STATE_MASK) | 
(*(src - 3) » RB_STATE_SIZE) ; 

ftelse 

*(dest - 3) = r_shift_and_dupt* (src - 3)]; 

tfendif 

/* FALLTHROUGH! ! */ 
case 2: 
#ifndef RB USE LOOKUP 

Mdest - 2) = (Msrc - 2) & RB_CUR_STATE_MASK) | 
(*(src - 2) >> RB_STATE_SIZE) ; 

#else 

Mdest - 2) = r_shif t_and_dup(* (src - 2)]; 

tfendif 

/* FALLTHROUGH! ! */ 
case 1: 
#ifndef RB_USE_LOOKUP 

Mdest - 1) = (Msrc - 1) & RB_CUR_STATE_MAS K ) | 
(*(src - 1) >> RB_STATE_SIZE) ; 



flelse 
#endif 



Mdest - 1) = r_shif t_and_dup (Msrc - 1)); 

/* FALLTHROUGH ! ! */ 
case 0: 



/* FALLTHROUGH! ! */ 

} 

) 

} 

/* 

* Finally, we set the number of elements of the latest region 

* builder. We also return the updates row variable. 
*/ 

R_CurRB->rrb_Nels = dest_index; 
*row_ptr a row; 
return TRUE; 
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} 

tfelse 
int 

R add_row to_region_builder 
C 



R_Int 

int 

int 



**row_ptr, 

rgn_mask, 

first 



R_Int 
R_Int 

unsigned char 
int 

int 

unsigned char 
unsigned char 
unsigned char 
register R_Int 
R_Int 

register R_Int 

R_Int 

int 

int 



♦row; 

rb_run_start; 
rb_prev_run_state ; 
row_on ; 

dest_index; 
*src_statejptr; 
*dest_state_ptr ; 
*src_state_end_ptr; 

*src_rgnj>tr; 

* s r c_rgn_e nd_p t r ; 

*dest_rgn_ptr; 

* de s t _rgn_e nd _p t r ; 
inc; 

i; 



ASSERT (rgnjnask == 1 | | rgn_mask == 2); 

row = *row_ptr; 
r_swap_region_builders ( ) ; 
/* 

* Skip over the row's y value at the beginning. 
*/ 

ASSERT (* row == R_NEXT_IS_Y) ; 
row += 2 ; 

ASSERT (*row != R_NEXT_IS_Y *row != R_EOR) ; 

if (r_PrevRB->rrb_Nels == 0) 
{ 

* If the current region builder's src region data array is empty, then 

* we are dealing with an empty region builder. We simply convert 

* the input row to the region builder format. 
V 

row_on = TRUE; 
dest_index = 0; 

while ( R_N0T JSND_0F_R0W ( * row ) ) 

if (++dest_index > R_CurRB->rrb_Size) 

if ( !r_grow_region_builder (R_CurRB, dest_index) ) 
return FALSE ; 

} 

R_CurRB->rrb_RgnData ldest_index - 1] = *row; 
if (row_on) 

R_CurRB->rrb_StateData [dest_index - 1] = 

(rgn_mask << RB_STATE_SIZE) ; 

else 

R_CurRB->rrb_StateData [dest_index - 1] = 0; 
row_on = !row_on; 
row+ + ; 

} 

*row_ptr = row; 

R_CurRB->rrb_Nels = dest_index; 
return TRUE; 

} 

/* 

* Firstly, we copy any runs from the region builder which 
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* precede this run from the region. We are checking the 

* starting row against the start of each pixel run. Therefore 

* we start checking against the lnd region builder data 

* element. 
*/ 

src_state_ptr = r_PrevRB->rrb_StateData; 
src_rgn_ptr = r_PrevRB->rrb_RgnData; 

src_state_end_ptr = src_state_ptr + r_PrevRB->rrb_Nels ; 
src_rgn_end_ptr = src_rgn_ptr + r_PrevRB- >rrb_Nels; 
dest_state_ptr = R_CurRB->rrb_StateData; 
dest_rgn_ptr = R_CurRB->rrb_RgnData; 
dest_rgn_end_ptr = dest_rgnjptr + R_CurRB->rrb_Size; 

ASSERT (r_PrevRB->rrb_Nels >= 2); 

while (src_rgn_ptr •!= src_rgn_end_ptr && *row > *src_rgn_ptr) 

src_rgn_ptr++; 
inc = src_rgn_ptr - r_PrevRB- >rrb_RgnData ; 

if {inc > 0) 
{ 

src_state_ptr += inc; 
dest_state_ptr += inc; 
dest_rgn_ptr += inc; 

if (dest_rgn_ptr > dest_rgn_end_ptr) 

if (i r_grow_region_builder (R_CurRB, inc) ) 

return FALSE; 
dest_state_ptr = R_CurRB- >rrb_StateData; 
dest_rgn_ptr = R_CurRB- >rrb_RgnData ; 
dest_rgn_end_ptr = dest_rgn_ptr + R_CurRB- >rrb_Size 

) 

1 

const R_Int * const src_rgn_ptr2 = src_rgn_ptr,- 

• R_Int *dest_rgn_ptr2 = dest_rgn_ptr; 

switch (inc) 
{ 

default: 

for (i = inc; i > 10; i--) 

* (dest_rgn_ptr2 - i) = * ( s rc_rgn_pt r - i) ; 

} 

/* FALLTHROUGH! ! */ 
case 10: 

* (dest_rgn_ptr2 - 10) = * (src_rgn_ptr2 - 10); 
/* FALLTHROUGH! ! */ 
case 9: 

* (dest_rgn_ptr2 - 9) = * (src_rgn_ptr2 - 9) ; 
/* FALLTHROUGH! ! */ 
case 8: 

* (dest_rgn_ptr2 - 8) = * (src_rgn_ptr2 - 8) ; 
/* FALLTHROUGH! ! */ 
case 7: 

* (dest_rgn_ptr2 - 7) = * (src_rgn_ptr2 - 7) ; 
/* FALLTHROUGH! ! */ 
case 6 : 

* (dest_rgn_ptr2 - 6) = * (src_rgn_ptr2 - 6) ; 
/* FALLTHROUGH! ! */ 
case 5: 

* (dest_rgn_ptr2 - 5) = * (src_rgn_ptr2 - 5) ; 
/* FALLTHROUGH! ! */ 
case 4 : 

* (dest_rgn_ptr2 - 4) = * (src_rgn_ptr2 - 4) ; 
/* FALLTHROUGH! ! */ 
case 3: 

* (dest_rgn_ptr2 - 3) = * (src_rgn_ptr2 - 3); 
/* FALLTHROUGH! ! */ 
case 2: 

* (dest_rgn_ptr2 - 2) = * (src_rgnjptr2 - 2); 



tfelse 
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/* FALLTHROUGH ! I */ 
case 1: 

* (dest_rgn_ptr2 - 1) = * (src_rgnjptr2 - 1) ; 
/* FALLTHROUGH! ! */ 
case 0: 

/* FALLTHROUGH! ! */ 

) 

memcpy 
( 

R_Cu rRB - > rrb_Rg nDa t a , 
r_PrevRB- >rrb_RgnData , 
inc * sizeof (R_Int) 

); 



ftendif 



if (ifirst) 
{ 

memcpy 
( 

R_CurRB - > r r b_S t a t eDa t a , 
r_Pr e vRB - > r r b_S t a t e Da t a , 
inc * sizeof (unsigned char) 

); 

) 

else 

{ 

switch (inc) 
{ 

default: 

for (i = inc; i > 10; i--) 

{ 

Hifndef RB_USE_LO0KUP 

* (dest_state_ptr - i) = ( * ( src_state_ptr - i) & 

RB_CUR_S T ATE_MAS K ) | 
(* (src_state_ptr - i) >> 
RB_STATE_SIZE) ; 

#else 

* (dest_state_ptr - i) = r_shif t_and_dup [* (src_statejptr - i)J 

#endif 

} 

/* FALLTHROUGH! ! */ 
case 10: 
tfifndef RB_USE_LO0KUP 

*(dest_statejptr - 10) = ( * (src_state_ptr - 10) & 

RB_CUR_STATE_MASK) | 
(* (src_state_ptr - 10) >> 
RB_STATE_SIZE) ; 

#else 

*(dest_state_ptr - 10) = r_shif t_and_dup(* (src_state_ptr - 10) J; 

ttendif 

/* FALLTHROUGH ! ! */ 
case 9: 
ttifndef RB_USE_LOOKUP 

*(dest_state_ptr - 9) = (* (src_state_ptr - 9) & RB_CUR_S TATE_MAS K ) 

(* (src_state_ptr - 9) >> RB_STATE_SIZE) ; 

tfelse 

* (dest_state_ptr - 9) = r_shif t_and_dup I* (src_state_ptr - 9)]; 

Hendif 

/* FALLTHROUGH ! ! */ 
case 8: 
ttifndef RB_USE_LOOKUP 

* (dest_state_ptr - 8) = (* (src_state_ptr - 8) & RB_CUR_STATE_MAS K ) 

(* (src_statejptr - 8) >> RB_STATE_SIZE) ; 

Helse 

* (dest_state_ptr - 8) = r_shif t_and_dup [* (src_state_ptr - 8)]; 

ttendif 

/* FALLTHROUGH! • */ 
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case 7: 
flifndef RB_USE_LOOKUP 

* (dest_state_ptr - 7) = {* (src_state_ptr - 7) & RB_CUR_STATE_MASK) | 

(Msrc_state_ptr - 7) >> RB_STATE_SIZE) ; 

ttelse 

* (dest_state_ptr - 7) = r_shif t_and_dup[* (src_state_ptr - 7) ) ; 

Bendif 

/* FALLTHROUGH! ! */ 
case 6: 
Jtifndef R_USE__LOOKUP 

* (dest_state_ptr - 6) = (* {src_8tate_ptr - 6) & RB_CUR_STATE_MAS K ) | 

(Msrc_state_ptr - 6) >> RB_STATE_SIZE) ; 

ftelse 

* (dest_state_ptr - 6) = r_shif t_and_dup (* (src_state_ptr - 6) ) ; 

ttendif 

/* FALLTHROUGH! ! */ 
case 5: 
ftifndef RB_USE_LOOKUP 

Mdest_state_ptr - 5) = (* (src_state_ptr - 5) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 5) >> RB_STATE_SIZE) ; 

#else 

* (dest_statejptr - 5) = r_shif t_and_dup [Msrc_state_ptr - 5) ] ; 

ffendif 

/* FALLTHROUGH ! ! */ 
case 4 : 
Jtifndef RB_USE_LOOKUP 

* (dest_state_ptr - 4) = ( * (src_state_ptr - 4) & RB_CUR_STATE_MASK) | 
^ (* (src_state_ptr - 4) >> RB_STATE_SIZE) ; 

#else 

* (dest_state_jptr - 4) = r_shif t_and_dup [* (src_state_ptr - 4)]; 

tfendif 

/* FALLTHROUGH! ! */ 
case 3 ; 
tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - 3 ) = (* (src_state_ptr - 3) & RB_CUR_S T ATE_MAS K ) | 

(* (src_Statejptr - 3) >> RB_STATE_SIZE) ; 

#else 

* (dest_state_ptr - 3) = r_shif t_and_dup(* (src_state_ptr - 3)]; 

tfendif 

' /* FALLTHROUGH! ! */ 
case 2 : 
ttifndef RB_USE__ LOOKUP 

* (dest_state_ptr - 2) = (* (src_state_ptr - 2) fit RB_CUR_STATE_MAS K ) | 

(*(src_state_ptr - 2) >> RB_STATE_SIZE) ; 

#else 

* (dest_state_ptr - 2) = r_shif t_and_dup [* (src_state jatr - 2)]; 

tfendif 

/* FALLTHROUGH! ! */ 
case 1 : 
flifndef RB_USE_LOOKUP 

* (dest_state_ptr * 1) = (* (src_statejptr - 1) & RB_CUR_S TAT E_ MAS K ) | 

(* (src_state_ptr - 1) >> RB_STATE_SIZE) ; 



#else 
tfendif 



* (dest_state_ptr - l) ■ r_shif t_and_dup(* (src_state_ptr - 1)1; 



/* FALLTHROUGH! ! */ 
case 0: 



/ * FALLTHROUGH ! ! * / 

} 

} 

) 

if (src_statejptr == src_state endjptr) 
{ 

/* 

* We've already exhausted the previous region builder. Set the start 

* of the next pixel run to be the max. possible and set the state 

* to be 0. 
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*/ 

rb_run_start = R_INT_MAX_VALUE - 2; 
rb_prev_run_state = 0; 

) 

else 
{ 

/* 

* We are still within the previous region builder bounds. Set up 

* the run info appropriately. 
*/ 

rb_run_start = *src_rgn_ptr; 
if (src_state_ptr == r_PrevRB- >rrb_StateData) 
rb_prev_run_state = 0 ; 

else 

rb_prev_run_state = * (src_state_ptr - 1) ; 

} 

/* 

* We can now start dealing with the elements in the row. 
*/ 

row_on = 1; 

while (R_NOT END_0F_R0W (*row) ) 
{ 

if (*row < rb_run_start) 

if (dest_rgn_ptr + 1 > dest_rgn_end _ptr) 

if ( ! r_grow_region_builder (R_CurRB, dest_rgn_ptr - R_CurRB- 

>rrb_RgnData + 1)) return FALSE; 
dest_state_ptr » R_CurRB->rrb_StateData; 
dest_rgnjDtr = R_CurRB->rrb_RgnData ; 
dest~rgn_end_ptr = dest_rgnjptr + R_CurRB->rrb_Size ; 

) 

*dest_rgn_ptr = *row; 

if (first) 

{ 

/* 

* We are processing the first region. Therefore, we 

* copy the current state of the run to the lowest 

* RB_STATE_SIZE bits. 
*/ 

*dest_statejptr = (rbj?rev_run_state & RB_CUR_S T ATE_MAS K ) | 
(rbjprev run_state >> RB_STATE_SIZE) ; 

} • 

else 
{ 

/* 

* We are processing the second region. Therefore, the state data 

* has already been copied to the previous state area so we 

* just copy the state. 
*/ 

*dest_state_ptr = rb_prev_run_state ; 

) 

/* 

* Now, if the row for the current region is active at this transition, 

* we xor the region mask with the current contents of the new region 

* builder slot- This gives the desired behaviour of making that region 

* active if it is not there already, but turns it off if it is... 
*/ 

if (row_on) 

*dest_state_ptr *o <rgn_mask << RB_STATE_SIZE) ; 
dest_state_ptr++ ; 
dest_rgn_ptr++ ; 
/* 

* We now move onto the next row element . 

•/ 

row++; 

row on « !row_on; 



-62- 



continue; 

} 

* If the current row transition point is equal in x position to the current 

* previous region builder transition point, we advance the row counter to 

* the next position. 

V 

if (*row == rb_run_start) 

{ 

row++; 

row_on = !row_on; 

) 

/* 

* Output the previous regions builder's transition region. We do similiar 

* things as for the region transition stuff above.. Firstly though, we 

* advance the rb_prev_run_state variable to the next element. We know 

* we can do this because if we were on the last element, we wouldn't 

* have hit this section of code. 
*/ 

rb_prev_run_state = *src_state_ptr ; 

if (dest_rgn_ptr + 1 > dest_rgn_end_ptr) 

if ( !r_grow_region_builder(R_CurRB, dest_rgn_ptr - R_CurRB->rrb_RgnData 

+ 1) ) return FALSE; 
dest_state_ptr = R_CurRB->rrb_StateData; 
dest_rgn_ptr = R_CurRB->rrb_RgnData; 
dest_rgn_end_ptr = dest_rgn_ptr + R_CurRB->rrb_Size; 

} 

*dest_rgn_ptr = rb_run_start ; 
if (first) 

*dest_state_ptr = (rb - prev_run_state & RB_CUR_STATE_MASK) | 
(rb_prev_run_state >> RB_STATE_SIZE) ; 

} 

else 

{ 

*dest_state_ptr = rb_prev_run_state; 

} 

if (!row_on) 

*dest_state_ptr (rgn_mask << RB_STATE_SIZE) ; 

dest_state_ptr++ ; 
dest_rgn_ptr++ ; 
/* 

* We've output the previous region builder's transitions. We now move 

* over onto the next transition. If the previous src_index increment 

* has moved us onto the last element, we declare that we have run 

* out of previous region builder data . 
*/ 

ASSERT (rb_run_start != R_EOR) ; 
++src_rgn_ptr; 

if (++src statejptr src state_end_ptr) 
{ 

/* 

* We've run out of data.. 
*/ 

rb_run_start = R_ I NT_MAX_V ALUE - 2; 
continue; 

} 

/* 

* Otherwise, we still have stuff left to do, so we move onto 

* the next run in the previous region builder. 
*/ 

rb_run_start = *src_rgn_ptr ; 



Now, we simply blast out any remaining region builder transition 
points . 
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if (src_state_ptr != src_state_end_ptr) 
R_Int nels_to_copy; 

nels_to_copy~= src_state_end_ptr - src_state_ptr ; 
if (dest_rgn_ptr + nels_to_copy > dest_rgn_end_ptr) 
{ 



if 
( 



! r_grow_region_builder 
( 

R CurRB, 

dest_rgn_ptr - R_Cu r RB - > r rb_Rg nDa t a + nels_to_copy 

) 



) 



return FALSE; 
dest_state_ptr = R_CurRB- >rrb_StateData ; 
dest_rgn_ptr = R_CurRB->rrb_RgnData; 

} 

memcpy 
( 

dest_rgn_ptr, 
src_rgn_ptr, 

nels to_copy * sizeof (R_Int) 

); 

dest_rgn_ptr += nels_to_copy ; 

if (Ifirst) 

{ 

memcpy 
( 

dest_state_ptr, 
src_state_ptr, 

nels_to_copy * sizeof (unsigned char) 

) ; 

} 

else 
{ 

i = nels_to_copy; 

src_state_ptr = src_state_end jptr; 
dest_statejptr += nels_to_copy ; 
switch (i) 
{ 

default: 

for (; i > 10; i--) 

{ 

#ifndef RB USE LOOKUP s , 

~ " * (dest_state_ptr - i ) = (* (src_state_ptr - i) & RB_CUR_S TATE_MAS K ) | 

{* (src_state_ptr - i) >> RB_STATE_SIZE) ; 

#else 

* (dest_state_ptr - i) = r_shif t_and_dup [* (src_state_ptr - i)J; 

#endif 

} 

/* FALLTH ROUGH ! ! */ 
case 10: 
flifndef RB USE LOOKUP 

* <dest_state_ptr - 10)= {* (src_state_ptr - 10) &RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 10) >> RB_STATE_SIZE) ; 

#else 

* (dest_state_ptr - 10) = r_shif t_and_dup t* (src_state_ptr - 10) J; 

ttendif 

/* FALLTHROUGH! ! */ 
case 9: 

tfifndef RB USE LOOKUP t , 

~ " *(dest_state_ptr - 9) = <* (src_state_ptr - 9) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 9) >> RB_STATE_SIZE) ; 

ft el se 

* (dest_state_ptr - 9) = r_shif t_and_dup (* (src_state__ptr - 9)); 

tfendif 

/* FALLTHROUGH' ! */ 
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case 8: 
ffifndef RB_USE_LOOKUP 

* (dest_state_ptr - 8) = (* (src_State_ptr - 8) & RB_CUR_STATE_MASK) | 

{* (src_state_ptr - 8) » RB_STATE_SIZE) ; 

ftelse 

* (dest_statejptr - 8) o r_shif t_and_dup I* (src_state_ptr - 8)1; 

Hendif 

/* FALLTHROUGH!! */ 

case 7: 
ffifndef RB_USE_LOOKUP 

* (dest_statejptr - 7) = (* (src_state_ptr - 7) & RB_CUR_STATE_MAS K ) | 

(* (src_state_ptr - 7) >> RB_STATE_SIZE) ; 

flelse 

* (dest_state_ptr - 7) = r_shif t_and_dup [* (src_state_ptr - 7)]; 

#endif 

/* FALLTHROUGH! ! */ 
case 6: 
ttifndef R_USE_LOOKUP 

* (dest_state_ptr - 6) = (* (src_state_ptr - 6) & RB_CUR_STATE_MASK) | 

(Msrc_state_ptr - 6) >> RB_STATE_SIZE) ; 

ftelse 

* (dest_state_ptr - 6) = r_shif t_and_dup (* (src_state_ptr - 6)1; 

#endif 

/* FALLTHROUGH ! ! */ 
case 5: 
Hifndef RB_USE_LOOKUP 

* (dest_state_ptr - 5) = {* (src_state_ptr - 5) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 5) >> RB_STATE_SIZE) ; 

flelse 

* (dest_state_ptr - 5) = r_shif t_and_dup [* (src_statejptr - 5)1; 

#endif 

/* FALLTHROUGH! ! */ 
case 4 : 
tfifndef RB_USE_LOOKUP 

* (dest_statejptr - 4) = (* (src_state_ptr - 4) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 4) >> RB_STATE_SIZE) ; 

ftelse 

* (dest_state_ptr - 4) = r_shif t_and_dup [* (src_state_ptr - 4)1; 

ttendif 

/* FALLTHROUGH! ! */ 
case 3 : 
tfifndef RB_USE_LOOKUP 

* (dest_state_ptr - 3) = (* (src_state_ptr - 3) & RB_CUR_STATE_MAS K ) | 

(* (src_state_ptr - 3) » RB_STATE SIZE) ; 

tfelse 

Mdest state_ptr - 3) = r_shif t_and_dup [* (src_state_ptr - 3)]; 
#endif ' 

/* FALLTHROUGH! ! */ 
case 2 : 
tfifndef RB_USE_LOOKUP 

Mdest_state_ptr - 2) = (* (src_state_ptr - 2) & RB_CUR_STATE_MASK) | 

(* (src_state_ptr - 2) >> RB_STATE_SIZE) ; 

tfelse 

Mdest_state_ptr - 2) = r_shif t_and_dup (* (src_state_ptr - 2)); 

Hendif 

/* FALLTHROUGH! ! */ 
case 1: 
ffifndef RB_USE_LOOKUP 

* (dest_state_ptr - 1) = {* (src_statejptr - 1) & RB_CUR_STATE_MASK) | 

(*(src_state_ptr - 1) >> RB_STATE_SIZE) ; 



#else 
ttendif 



* (dest_state_ptr - 1) = r_shif t_and_dup [* (src_state_ptr - 1)1; 

/* FALLTHROUGH!! */ 
case 0: 

/* FALLTHROUGH! ! */ 
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) 

} 

/* 

* Finally, we set the number of elements of the latest region 

* builder. We also return the updates row variable. 
*/ 

R_CurRB->rrb_Nels = dest_rgn_ptr - R_CurRB->rrb_RgnData; 
*row_ptr = row; 
return TRUE; 

} 

flendif 
/* 

* r_check_rgn_buf_len 
* 

* This function checks to see if the static region buffer is large enough. 

* If it isn't then it is reallocated to make it large enough. 
* 

* Parameters: 

* size The required size of the r_RegBuf array. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

static int 
r_check_rgn buf — len 
( 

int size 

) 
{ 

ASSERT (size >= 0) ; 
. if (size > r_RgnBufSize) 

{ 

int new_buf_size; 
R_Int *new_buf; 

new_buf_size = max(size, r_RgnBufSize * 2) ; 

new_buf = (R_Int Mmalloc (new_buf_size * sizeof (R_Int ) ) ; 

if (new_buf = = NULL) 

return FALSE; 
if (r_RgnBuf != NULL) 

^ memcpy(new_buf , r_RgnBuf, r_RgnBufSize * 9izeof (R_Int) ) ; 
free (r_RgnBuf ) ; 

} 

r_RgnBuf = new_buf; 
r_RgnBufSize = new_buf_eize ; 

) 

return TRUE; 

} 

/* 

* R_init_region_with_rect 

* This function initialises a R_Region structure to represent a rectangular 

* region. It is assumed that the region is currently uninitialised. 
* 

* Parameters: 

* rgn A pointer to the R_Region to be initialised. 

* rect A pointer to an IntXYMinMax structure representing 

* the rectangular area requiring an equivalent region 

* description. 

* Returns: 

* TRUE on success, FALSE on failure. 

*/ 
int 

R_i n i t_r eg i on_w i t h_rec t 
( 

R_Region *rgn, 
IntXYMinMax *rect 
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) 
{ 

R_Int *rgn_data; 

ASSERT ( rect - >X . Min <= rect->X .Max) ; 
ASSERT ( rect - > Y . Min <= rect ->Y. Max) ; 

rgn->rr_BBox = *rect; 

rgn_data = (R_Int *)malloc{9 * sizeof (R_lnt ) ) ; 
if (rgn_data == NULL) 

{ 

return FALSE; 

} 

rgn_data(0] = R_NEXT_ISJY; 
rgn_data[l] = rect ->Y. Min; 
rgn_data[2) = rect->X.Min; 
rgn_data[3] = rect ->X. Max + 1; 
rgn_data[4] = R_NEXT_IS_Y; 
rgn_data[5] = rect -> Y.Max + 1; 
rgn_data[6) = rect ->X. Min ; 
rgn_data[7] = rect ->X. Max + 1; 
rgn_da t a 1 8 ] = R_EOR ; 
rgn->rr_RgnData = rgn_data; 
rgn->rr_RgnDataSize = 9; 
return TRUE; 

} 

* R_region_with_region 

* This function initialises a R_Region structure to represent a the region 

* passed as an argument. It is assumed that the region is currently 

* uninitialised. 
* 

* Parameters: 

* rgn A pointer to the R_Region to be initialised, 

* src_rgn A pointer to an R_Region structure representing 

* the region to which this region is to be initialised. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_init_region_ with_region 
( 

R_Region *rgn, 
R_Region *src_rgn 

) 
{ 

R_Int *rgn_data; 
rgn->rr_BBox = src_rgn->rr_BBox; 

rgn_data = (R_Int Mmalloc (src_rgn->rr_RgnDataSize * sizeof (R_Int) ) ; 
if (rgn_data NULL) 

{ 

return FALSE; 

) 

memcpy 
( 

rgn_data, 

s r c_rg n - > r r_RgnDa t a , 

src_rgn->rr_RgnDataSize * sizeof (R_Int) 

) ; 

rgn->rr_RgnData = rgn_data; 

rgn->rr_RgnDataSize = src_ rgn- >rr_RgnDataSize ; 
return TRUE; 

) 

/* 
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R_region_with_translated_region 

This function initialises a RJlegion structure to represent a the region 
passed as an argument translated by delta. It is assumed that the region 
is currently uninitialised. 

Parameters : 

rgn A pointer to the R_Region to be initialised. 

src_rgn A pointer to an R_Region structure representing 

the region to which this region is to be initialised, 
delta A pointer to a intXY structure representing the 

translation required. 

Returns : 

TRUE on success, FALSE on failure. 

>/ 
int 

R_i n i t_r eg i on_ w i t h_t rans 1 ate d_r eg ion 
( 

R_Region *rgn, 
R_Region *src_rgn, 



IntXY *delta 



R_Int *rgn_data; 
R_Int *src_data; 

rgn->rr_BBox.X.Min = src_rgn->rr_BBox.x.Min + delta->X; 

rgn ->rr_BBox. X.Max = src_rgn->rr_BBox. X.Max + delta->X; 

rgn->rr_BBox.Y.Min = src_rgn->rr_BBox. Y.Min + delta->Y; 

rgn- >rr_BBox. Y.Max = src_rgn->rr_BBox. Y.Max + delta->Y; 

rgn_data = (R_Int *)malloc (src_rgn->rr_RgnDataSize * sizeof (R_Int) ) ; 

if (rgn_data == NULL) 

{ 

return FALSE; 

) 

src_data = src_rgn->rr_RgnData; 

for (int i = 0; i < src_rgn->rr_RgnDataSize; i++) 

{ 

if (src_data[i) == R_NEXT_IS Y) 
{ 

rgn_data[i] = src_data(ij; 
i++; 

rgn_data(i) = src_data[i] + delta- >Y; 
continue; 

) 

else if (src_data[il == R_E0R) 
rgn_data[i] = src_data[i); 

else 

rgn_data[i] = src_data(i] + delta->X; 

) 

rgn- >rr_RgnData = rgn_data; 

rgn->rr_RgnDataSize = src_rgn- >rr_RgnDataSize ; 
return TRUE; 



* R_empty_region 
* 

* Deallocates the region data allocated for a region. Only the 

* data is freed. The R_Region structure itself is not. 
* 

* Parameters: 

* rgn The region whose region data is to be deallocated. 

* Returns: 

* Nothing . 
*/ 

void 
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R empty_region 
C 

R_Region *rgn 

{ 

if (rgn != NULL && rgn- >rr_RgnData != NULL) 

{ 

f ree (rgn->rr_RgnData) ; 
rgn->rr_RgnData = NULL; 

} 

} 

tfifndef R_USE_NEW_IMP 
/* 

* Reunion 

* This function inits a R_Region structure to represent the union 

* of it's two arguments. 

* Parameters : 

* rgn The R_Region to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 

*/ 
int 

Reunion 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags; 

union_tot++ ; 

if ( !BB_intersect_test (&rl->rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 
( 

/* 

* The bounding boxes don't intersect. This means we can do the 

* union very easily, simply by copying data from the two regions. 

* We malloc a new region data array of size rl- >rr_RgnDataSize + 

* r2- >rr_RgnDataSize - 1. This is the maximum possible size of 

* resulting region. Not all of this memory will be utilised if 

* the two regions being combined have rows with the same y coordinate 

* (R_NEXT_IS_Y marker is not duplicated) . 
*/ 

rgn->rr_RgnDataSize = rl- >rr_RgnDataSize + r2->rr_RgnDataSize - 1; 
rgn->rr_RgnData = (R_Int *) malloc (rgn- >rr_RgnDataSize * 

sizeof (R_Int) ) ; 

if (rgn->rr_RgnData == NULL) 



return FALSE; 



* Now, check to see if the regions overlap in y. 
*/ 

if { ! (overlap_f lags & BB_INTERSECT_OVERLAP_Y) ) 



{ 



/* 

* The regions don't overlap in y. We simply copy one region 

* and then another into the array we malloced. We ensure 

* that rl points to the region with the smallest y coordinate. 
*/ 

if (r2->rr BBox.Y.Min < rl->rr BBox. Y.Min) 
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{ 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp; 

) 

memcpy 
( 

rgn->rr_RgnData, 
rl - >rr_RgnData , 

(rl->rr_RgnDataSize - 1) * sizeof (R_Int) 

); 

memcpy 
( 

rgn->rr_RgnData + rl->rr_RgnDataSize - 1, 
r2->rr_RgnData, 

r2->rr RgnDataSize * sizeof (R_Int) 

); 

ASSERT ( rgn- >rr_RgnData (rgn->rr_RgnDataSize - 1] == R_EOR) ; 



R_Int 


*rl_tmp; 


R_lnt 


*r2_tmp; 


R_Int 


♦dest; 


R_Int 


min_row; 


int 


rl_done; 


int 


rl_consumed; 


int 


r2_consumed; 


int 


num_written; 


/* 





* The bboxes overlap in y but not in x. We simply go row 

* by row through each region and memcpy the individual rows as 

* appropriate. We ensure that rl points to the region with 

* the smallest x coordinate. 
*/ 

if (r2->rr_BBox.X.Min < rl->rr_BBox.X .Min) 

{ 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp; 

) 

rl_dat a rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
dest =* rgn->rr_RgnData; 
rgn->rr_RgnDataSize = 0; 
rl_consumed = 0; 
r2_consumed = 0; 

while (*rl_dat != R_EOR && *r2_dat != R_EOR) 
{ 

ASSERT (*rl_dat == R_NEXT_IS_Y) ; 

ASSERT (*r2_dat == RJIEXT_IS_Y) ; 

min_row = min (rl_dat (1] , r2_dat[l]); 

rl_done = FALSE ; 

if (rl_dat[l) == minjow) 

{ 

/* 

* We need to emit rl . We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values. . 
*/ 

rl_tmp = rl_dat + 4; 

while (*rl_tmp != R_NEXT_IS_Y && *rl_tmp != R_E0R) 

rl_tmp++ ; 
num_written = rl_tmp - rl_dat; 

memcpy(dest, rljdat, num_written * sizeof (R_Int) ) ; 



-70- 



dest ♦= num_written; 
rl_consumed ♦= num_written; 
rgn->rr_RgnDataSize += num_written; 
rl_dat = rl_tmp; 
rl_done = TRUE; 

} 

if (r2_datfl] == min_row) 
{ 

/* 

* We need to emit rl . We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values. If rl's current row has already been 

* emitted for this y value, we do _not_ emit the 

* R_NEXT_IS_Y marker or the y value itself. 
*/ 

if (rl_done) 

{ 

r2_dat += 2; 

r2_tmp a r2_dat + 2; 

r2_consumed += 2; 

) 

else 

{ 

r2_tmp = r2_dat + 4; 

} 

while (*r2_tmp != R_NEXT_IS_Y *r2_tmp != R_EOR) 

r2_tmp++; 
num_written = r2_tmp - r2_dat; 

memcpy (dest, r2_dat, num_written * sizeof (R_Int) ) ; 
dest += num_written; 
r2_consumed += num_written; 
rgn->rr_RgnDataSize += num_written; 
r2_dat « r2_tmp; 



(*rl_dat != R_E0R) 
/* 

* rl is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R_EOR marker) to the destination. 
*/ 

ASSERT (r2_consumed == r2->rr_RgnDataSize - 1) ; 

memcpy 

( 

dest, 
rl_dat, 

(rl->rr_RgnDataSize - rl_consumed) * sizeof (R_Int) 

); 

rgn->rr_RgnDataSize += (rl->rr_RgnDataSize - rl_consumed) 



se 



/* 

* r2 is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R_EOR marker) to the destination. 
*/ 

ASSERT (rl_consumed == rl- >rr_RgnDataSize - 1) ; 

memcpy 

( 

dest, 
r2_dat, 

(r2->rr_RgnDataSize - r2_consumed) * sizeof (R_Int) 

) ; 

rgn->rr_RgnDataSize += (r2->rr_RgnDataSize - r2_consumed) ; 
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ASSERT 
( 



); 



rgn->rr_RgnDataIrgn->rr_RgnDataSize - 1) == R_EOR 



else 

( 



) 



• • • 

• • 

• • • 



• • • 



R_Int min_row; 

int dest_size; 
unsigned char *rgn_bld_stat ; 

R_Int *rgn_bld_dat; 

int i ; 

int in_run; 

int done_r l_in_row ; 

union_full++; 

/* 

* The two regions _do_ overlap in x _and y. We therefore have 

* to do a bit more work in calculating the union of the two 

* regions. We use the R_RegionBuilder struct to store state 

* regarding the currently active regions as we progress through 

* the rows of each region. After any rows relevent to a y-coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row(s) 

* for the y-coord have caused a transition to or from 0, then 

* the pixel run is emitted. However, the first thing we do is 

* ensure the current region builder is empty. 
*/ 

rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
R_CurRB->rrb_Nels = 0 ; 
•••• dest size = 0; 

mm m /* 

* We are now ready to loop through the data of both regions. 

* We continue building the new region whilst there is data 
• • • * remaining in either of the two regions. 

•••• */ 

while (*rl_dat 1= R_EOR || *r2_dat != R_EOR) 

{ 

ASSERT (*rl_dat == R_NEXT_IS_Y || *rl_dat == R_E0R) ; 
ASSERT (*r2_dat == R_NEXT_IS_Y jj *r2_dat == R_EOR) ; 
if (*rl_dat == R_E0R) 

min_row = r2_dat [ l ] ,- 
else if (*r2_dat == R_E0R) 
min__row = rl_dat[l]; 

else 

min_row = min(rl_dat (1) , r2_dat (1) ) ; 
done_rl_in_row = FALSE; 

if (*rl_dat != R_EOR rl_dat(l) == min_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&rl_dat , 0x1, TRUE) ) 

return FALSE ; 
done rl in_row = TRUE ; 

) 

if (*r2_dat 1= R_EOR && r2_dat(l] == min_row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&r2_dat, 0x2, ! done_rl_in_row) ) 



• ••• 
• • • 

• • • 



• • • 



-72- 



• • • • 

> • • 

• • • 



• • • • 

» • • 

• • • 



return FALSE; 

) 

/* 

* Now, we generate the output row for the input rows. 
*/ 

if ( ! r_check_rgn_buf len(dest_size + 2)) 
{ 

return FALSE; 

) 

r_RgnBuf (dest_size++) = R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
rgn_bld_stat = R_CurRB->rrb_StateData; 
rgn_bld_dat = R_ CurRB->rrb_RgnData; 
in_run = FALSE ; 

for (i = -R_CurRB->rrb Nels; i > 0; i- - ) 

{ 



if 
( 



*rgn_bld_stat > 0 

&& 

( 

(*rgn_bld_stat & RB_CUR STATE_MASK) ==0 
II 

(*rgn_bld_stat & RB_PREV_STATE_MASK) ==0 

) 

) 
{ 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
*/ 

if ( ! in_run) 
{ 

if ( !r_check_rgn_buf_len(dest_size + 1)) 

{ 

return FALSE ; 

) 

r_RgnBuf [dest_size++] = *rgn_bld_dat ; 
in_run = TRUE; 

} 

} 

else 

{ 

if (in_run) 

{ 

i* 

* We've come to the end of a run. We output the next 
element to end it. 

*/ 

if ( ! r_check_rgn buf len(dest size + 1)) 
{ 

return FALSE ; 

} 

r_RgnBuf [dest_size++] = *rgn_bld_dat ; 
in_run = FALSE ; 

} 

rgn_bld_stat++ ; 
rgn_bld_dat++ ; 

) 

if (rRgnBuf [dest_size - 2] == RNEXT IS Y) 
{ 

/* 

* We didn't output anything for these input rows. Rewind.. 
*/ 

dest_size -= 2; 

} 
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/* 

* We've completed constructing the data for the region. We 

* make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int *)malloc (++dest_size * sizeof (R_lnt) ) ; 
if (rgn->rr RgnData == NULL) 

{ 

return FALSE; 

) 

memcpy (rgn- >rr_RgnData, r_RgnBuf, (dest_size - 1) * sizeof (R_Int ) ) ; 
rgn->rr_RgnData [dest_size - 1) = R_E0R; 
rgn->rr_RgnDataSize = dest_size; 
ASSERT ( rgn- >rr_RgnDataSize >= 9) ; 

/* 

* We now do a bounding box union of the two component bboxes and place 

* the result in the new region. 
V 

BB_union(&rl->rr_BBox, &r2->rr_BBox, &rgn- >rr_BBox) ; 
/* 

* Done ! We can get out . . 
*/ 

return TRUE; 

} 

/* 

* R_union_equals 

* This function basically implements a rl union= r2 type operation. Ie 

* rl union r2 is calculated and the result returned in rl . 
* 

* Parameters: 

* rl A pointer to an R_Region. This represents 

* the first half of the union, and is also used to return 

* the eventual result. 

* r2 A pointer to an R_Region. This represents the second 

* half of the union. 

* Returns : 

* TRUE on success, FALSE on failure. 
V 

int 

R_u n i on_e qua 1 s 
( 

R_Region *rl, 
R_Region *r2 



R_Reg ion new_rgn ; 

if (rl->rr_RgnData == NULL) 

return R_init_region_with_region (rl , r2) ; 
if ( '.Reunion (&new_rgn, rl, r2)) 

return FALSE; 
R_emptyregion(rl) ; 
*rl = new_rgn; 
return TRUE; 



* R_intersection 
* 

* This function inits a R_Region structure to represent the intersection 

* of it's two arguments. 
* 

* Parameters: 

* rgn A R_Region ptr to the R_Region structure to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 
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Returns 

TRUE on success, FALSE on failure. 



intersection 

R_Region *rgn, 

R_Region *rl , 

R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags ; 



int_tot++; 

rgn->rr_RgnData = NULL; 

if (!BB_intersectJ:estUrl->rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 
/* 

* The bounding boxes don't intersect. This means that the regions 

* don't intersect. Therefore, we simply set rgn- >rr_RgnData to NULL 

* (signifying an empty region) and get out.. 
*/ 

return TRUE; 

} 

R_Int min_row; 
int dest_size; 
unsigned char *rgn_bld_stat ; 

R _*nt *rgn_bld"dat ; 
int i ; 

i nt in_run; 

int done_rl_in_row ; 

I n tXYMinMax new_bbox ; 

int_full++ ; 



/* 

* 
* 



The two regions _do_ overlap in x _and y. We therefore have 
to do a bit more work in calculating the intersection of the two 
regions. We use the RJtegionBuilder struct to store state 
regarding the currently active regions as we progress through 
the rows of each region. After any rows relevent to a y-coord 
are added to the region builder, we examine the state of each 
pixel run in the region builder. If the addition of the row(s) 
for the y-coord have caused a transition to or from 0x3, then 
the pixel run is emitted. 



V 

/* 

^Initialise the new_bbox structure for determining the new bounding box. 

new_bbox.X.Min = R_INT_MAX_VALUE; 

newjbbox. Y.Min = R~INT_MAX_VALUE; 

new_bbox. X.Max = R~INT_MIN~VALUE; 

new_bbox. Y.Max = R_INT_MIN_VALUE; 

/* 

* The next thing we do is ensure the current region builder is empty, 
*^and set up pointers into the region data of the two regions. 

rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData ; 
R_CurRB->rrb_Nels = o ; 
dest_size = 0; 
/* 

* We are now ready to loop through the data from both regions. Notice 
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* that we only keep looping whilst _both_ regions have some data left 

* to give. As soon as either of the region's data has been exhausted, 

* then we stop as the intersection region has already been calculated 

* and is sitting in the rgn buf . 
*/ 

while (*rl dat != R EOR && *r2 dat != R EOR) 
( " 

ASSERT ( * rl_dat = = R_NEXT_IS_Y || *rl_dat » R_EOR) ; 
ASSERT (*r2~dat R_NEXT IS_Y || *r2_dat == R_EOR) ; 
if (*rl_dat == R_EOR) 

min_row => r2_dat(l); 
else if (*r2_dat == R_EOR) 
min_row = rl_dat[l); 

else 

min_row = min(rl_dat (1] , r2_dat (1) ) ; 
done_rl_in_row = FALSE; 

if (*rl dat != R EOR && rl dat(l) min row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&rl_dat, 0x1, TRUE)) 

return FALSE; 
done rl in row = TRUE; 

} 

if (*r2_dat != R EOR r2 dat(l) == min row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&r2_dat, 0x2, !done_rl_in_row> ) 
return FALSE; 

} 

/* 

* Now, we generate the output row for the input rows. 
V 

if (Jr_check_rgn_buf_len(dest_size +2)) 
return FALSE; 

} 

r_RgnBuf (dest_size++) = R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
rgn_bld_stat = R_CurRB- >rrb_StateData ; 
rgn_bld_dat = R_CurRB->rrb_RgnData ; 
in_run = FALSE; 

for (i = R CurRB->rrb Nels; i > 0; i--) 
{ 

if 
( 

*rgn_bld_stat != (3 | (3 << RB_STATE_SIZE) ) 
( 

(*rgn_bld_stat & RB_PREV__STATE MASK) == 3 
II 

(*rgn_bld_Stat & RB_CUR_STATE MASK) == {3 << RB STATE SIZE)) 

) 
{ 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
*/ 

if ( ! in_run) 

{ 

if ( ! r_check_rgn_buf_len (dest_size + 1)) 

{ 

return FALSE; 
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} 

r_RgnBuf tdest_size++) = *rgn_bld_dat ; 
in_run = TRUE; 

^ new_bbox.X.Min = min(new_bbox.X.Min, *rgn_bld_dat) ; 

) 

else 

{ 

if (in run) 

{ 

^ to e^ndTr t0 ° f 3 rUn ' WG ° UtpUt the next element 

V 

if ( lr_check_rgn_buf_len(dest_size + 1)) 
return FALSE; 

r_RgnBuf [dest_size++] = *rgn_bld_dat ; 

new_bbox. X.Max = max (new_bbox. X.Max/ *rgnbld__dat) ; 

in run = FALSE ; 

} 

rgn_bld_stat++ ; 
^ rgn_bld_dat++; 

if (r_RgnBuf [dest_size - 2] == R_NEXT_IS_Y) 
/* 

* We didn't output anything for these input rows. Rewind.. 

/ 

dest size -= 2; 

} 

else 

{ 

if (min_row < new_bbox. Y.Min) 
new_bbox. Y.Min = min_row; 
else if (min_row > new_bbox. Y.Max) 
newjfrbox. Y.Max = min_row ; 



} 



} 



* We've completed constructing the data for the region. Firstly 

. tLf/°. See " W6 ' Ve emitted an ything at all if we have 
then dest_size must be > o. If it isn't we simply free the 
region we created and get out. as the regions don't reallv 

^intersect, in spite of their intersecting bounding boxes. 

if (dest size == 0) 
{ 

return TRUE; 

) 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer "utter co 
*/ 

rgn->rr_RgnData = (R_mt *)malloc( ++ dest size * sizeof(R mt>>- 
if (rgn->rr_RgnData == NULL) ~ - 

return FALSE; 

} 



memcpy(rgn->rr_RgnData, r_RgnBuf, (dest size - 1) ♦ sizeof(R mtJl • 
rfn.>rr_Rgn0ataW«t=s4.et-slze ? R_eor ; ~ - Int) 1 ' 

"SSERT(rgn->rr_RgnDataSize~>= 9) ; 

* Now, copy across the bounding box. . Before we do this, we subtract 

* 1 from X.Max and Y.Max because of the region format. subtracc 



-77- 



*/ 

new_bbox . X . Max- - ; 
new_bbox . Y . Max- - ; 
rgn->rr_BBox = new bbox; 

h 

* Done ! We can get out . . 
V 

return TRUE; 

) 

* R_difference 

* This function inits a R_Region structure to represent the difference of 

* it's two arguments. It essentially calculates rl - r2 

* Parameters: 

* rgn A R_Region ptr representing the R_Region to be inited. 

* rl A R_Region ptr ^representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_dif ference 
( 



R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2~dat; 
int overlap_f lags; 



dif f_tot++; 

rgn->rr_RgnData = NULL; 

if ( !BB_intersect_test (&rl- >rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 
/* 

* The bounding boxes don't intersect. This means that rl - r2 

* simply equals rl. We make a copy of the relevant bits and get out. 
*/ 

rgn->rr_ BBox = rl->rr_BBox; 
rgn->rr_RgnDataSize = rl->rr_RgnDataSize; 

rgn->rr_RgnData = (R_lnt *) malloc (rl->rr_RgnDataSize * sizeof (R_Int ) ) 

if (rgn->rr_RgnData == NULL) 

{ 

return FALSE; 

} 

memcpy 
( 

rgn->rr_RgnData # 
rl->rr_RgnData, 

rl->rr_RgnDataSize * sizeof (R_Int) 

); 

return TRUE; 

} 

R_Int min_row; 

int dest_size; 

unsigned char *rgn_bld_stat ; 

Bnint irgn_bld_dat ; 

int in_run; 

int done_rl_in_row; 

unsigned char m_high; 
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unsigned char m_low; 
IntXYMinMax newjbbox; 

diff_f U ll++; 
/* 

* The two regions _do_ overlap in x _and y. We therefore have 

* to do a bit more work in calculating the difference of the two 

* regions. We use the R_RegionBuilder struct to store state 

* regarding the currently active regions as we progress through 

* the rows of each region. After any rows relevent to a y-coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row{s) 

* for the y-coord have caused the following transitions - 

* rl -> 0 
0 -> r2 

* rl + r2 -> r2 

* r2 -> rl + r2 

* ..then the relevent runs are emitted. Firstly, though, 

* we ensure the current region builder is empty, 

* and set up pointers into the region data of the two regions. 
*/ 

rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
R_CurRB->rrb_Nels = 0; 
dest_size = 0; 

/* 

* Initialise the new_bbox structure for determining the new bounding box. 
n£w_bbox.X.Min =32767; 

new_bbox.Y.Min = 32767; 
new_bbox. X.Max = -32768; 
new_bbox. Y.Max = -32768; 

/* 

* We are now ready to loop through the data from both regions. Notice 

* that we only keep looping whilst rl has data outstanding. When 

* rl's data is consumed, then any transitions made by r2 are 

* irrelevant. 
V 

while <*rl dat != R EOR) 
{ 

ASSERT (*rl_dat == R_NEXT_IS_Y | | *rl_dat == R_EOR) ; 
ASSERT (*r2_dat == R_NEXT_IS_Y jj *r2_dat == R_EOR) ; 
if (*rl_dat == R_E0R) 

min_row = r2_dattl]; 
else if (*r2_dat == R_EOR) 

min_row = rl_dat(l); 

else 

min_row = min (rl_dat [1] , r2_datll)); 
done_rl_in_row = FALSE ; 

if (*rl_dat != R_E0R && rl_dat[l] == min row) 
( 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to_region_builder (&rl_dat , 0x1, TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

) 

if (*r2_dat != R_EOR && r2_dat (1) == min row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 
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if ( !R_add_row_to_region_builder(&r2_dat, 0x2, !done_rl_in_row) ) 
return FALSE; 

} 

/* 

* Now, we generate the output row for the input rows. 
*/ 

if (!r_check_rgn_buf_len(de8t_size + 2)) 
{ 

return FALSE; 

) 

r_RgnBuf [dest_size++] = R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
rgn_bld_stat = R_CurRB->rrb_StateData; 
rgn_bld_dat = R_CurRB->rrb_RgnData; 
in_run = FALSE; 

for (i = R_CurRB~>rrb_Nels; i > 0; i--) 
{ 

m_high = (*rgn_bld_stat & RB_CUR_STATE_MASK) >> RB_STATE_SIZE; 

m_low = *rgn_bld_stat & RB_PREV_STATE_MASK; 

if 



( 



(m_low ! = 1 && m_high == 1) 

ii 

(m_low == l &6c m_high ! = 1) 



/* 

* We have to emit a run here, if we're not already 

* in one . . 
*/ 

if { ! in_run) 

( 

if ( lr_check_rgn_buf_len(dest_size + 1)) 
return FALSE; 

) 

r_RgnBuf [dest_8ize++] = *rgn_bld_dat ; 
in_run = TRUE; 

new_bbox.X.Min = min{new_bbox.X.Min, *rgn_bld_dat) ; 

} 

} 

else 

{ 

if (in_run) 

( 

/* 

* We've come to the end of a run. We output the next element 

to end it. 
*/ 

if ( !r_check_rgn_buf_len(dest_size + 1) ) 
{ 

return FALSE; 

) 

r_RgnBuf [dest_size++ J = *rgn_bld_dat ; 

new_bbox . X . Max = max(new_bbox.X .Max, *rgn_bld_dat ) ; 

} 

in_run = FALSE; 

) 

rgn_bld_stat++ ; 
r g n_b 1 d_da t + + ; 

} 

if (r_RgnBuf [dest_size - 2] == R_NEXT_IS_Y) 
{ 

/* 

* We didn't output anything for these input rows. Rewind.. 
*/ 
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dest size -= 2; 

) 

else 

{ 

if (min_row < new_bbox . Y . Min ) 
new_bbox. Y.Min = min_row; 

else if (min_row > new_bbox. Y.Max) 
new bbox. Y.Max = min row; 



/* 

* We've completed constructing the data for the region. Firstly 

* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0. If it isn't we simply free the 

* region we created and get out, as r2 - rl must be empty. 
*/ 

if (dest_size == 0) 
{ 

return TRUE; 

) 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int * ) malloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn- >rr_RgnData == NULL) 

{ 

return FALSE; 

} 

memcpy (rgn->rr_RgnData , r_RgnBuf, (dest_size - 1) * sizeof (R_Int) ) ; 

rgn->rr_RgnData[dest_size - 1] = R_E0R; 

rgn->rr_RgnDataSize = dest_size; 

ASSERT (rgn- >rr_RgnDataSize >= 9); 

/* 

* Now, copy across the bounding box. . 
*/ 

rgn->rr_BBox = new_bbox; 
/* 

* Done ! We can get out . . 
*/ 

return TRUE; 

} 

Hendif /* R_USE_NEW_IMP */ 
/* 

* r_grow_f ree_list 

* This function mallocs and adds R_FREE_LIST_GROWTH_SIZE new elements 

* to the front of the region growth free list. 
* 

* Parameters: 

* None . 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

int 

r_grow_f ree_list 0 

{ 

R_RgnGrowItem *rgi; 
int i ; 

/* 

* First, malloc the memory.. 
V 

rgi = (R_RgnGrowItem *) malloc 
( 

R_FREE_LIST_GROWTH_SIZE * sizeof (R_RgnGrowItem) 

); 

if (rgi == NULL) 
return FALSE; 
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} 



/* 

* Now make the whole block of memory into a list.. 
*/ 

for (i 8 0; i < R_FREE_LIST_GROWTH_SIZE - 1; i++) 
rgi (i) .rrgi_Next = &rgi(i + U ; 

/* 

* Now, add it to the front of the free list.. 
•/ 

rgi(R_FREE_LIST_GROWTH_SIZE - l).rrgi_Next = r_free_list; 
r_free_li8t = rgi; 
return TRUE; 



* R_add_row_to_region_growth_l ist 
# 

* This function adds a row from a R_Region to a linked list comprised of 

* R_RgnGrowItem structures. "Adding" implies that the linked list is 

* modified such that the state and coordinate information present 

* in the list is updated to take into account the new row just added. 

* Adding a row has the following properties: 

* * If a pixel run in the row does not exist in the list before, 

* it is added and it's current state is tagged with the region 

* to which the row belongs. The previous state is set to 0, 

* indicating that it did not exist before. 

* * If a pixel run in the row did exist before, but it's present state 

* indicates that it came from the other region then the run 

* is retained but it's state is modified to indicate that 

* both regions are active at this point. 

* * If a pixel run in the row did exist before, and it's present 

* state indicates that the current region then the region is 

* removed and it's state is modified to indicate that the run is 

* now empty. 

* * If a pixel run in the row did exist before, and it's present state 

* indicates that both regions are currently active then the run 

* is retained, but its state is modified to indicate that only the 

* other region is active in this run. 
* 

* Parameters: 

* rowjptr A R_Int ** pointer to the row in the region. Used 

* to return the updates row pointer. 

* rgn_mask A mask for the region the row comes from. Must 

* be either 1 or 2 . 

* first Whether this is the first region to be processed 

* on the current scanline. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_a dd_r o w_ t o_r eg i on_g row t h_l ist 
( 

R_Int **row_ptr, 
int rgn_mask, 
int first 



R_Int *row; 

R_Rg nG r ow 1 1 em * rg i ; 

unsigned char rb_prev_run_state ; 

int row_on; 

row = *row_ ptr; 
/* 

* Skip over the row's y value at the beginning. 
*/ 

ASSERT (* row == R_NEXT_IS_Y) ; 
row += 2; 

ASSERT {* row !=. R NEXT IS Y && *row != R_E0R) ; 
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If (r growth list == NULL) 
{ 

R_RgnGrowI t em * *pt r_next_pt r ; 
/* 

* The growth list is currently empty. Therefore, we simply convert 

* the input row to the region growth list format.. 
*/ 

row_on = TRUE; 

ptr_next_ptr = &r_growth_list ; 
while (R NOT END OF ROW(*row)) 

{ " " " " 

if (r_f ree_list == NULL) 

{ 

if ( !r_grow_f ree_list () ) 
return FALSE; 

} 

rgi = r_free_list; 
*ptrjnext_ptr = rgi; 
ptr_next_ptr = &rgi->rrgi_Next ; 
r_free_list = *ptr_next_ptr; 
rgi->rrgi_RgnData = *row; 
if (row_on) 

rgi->rrgi_StateData = (rgnjnask << RB_STATE_SIZE) ; 

else 

rgi->rrgi_StateData = 0; 
row_on = !row_on; 
row+ + ; 

} 

*row_ptr = row; 
*ptr_next_ptr = NULL; 
return TRUE; 



R_RgnGrowI tern f ake_i t em ; 
R_RgnGrowItem *prev_rgi ; 

/* 

* "fake_item M is used as the head of the list. This is so that we _always_ have 

* a valid pointer to the previous item in the list. Only the next pointer and 

* state data are initialised, as these are they only elements which will be 

* referenced. 

fake_item.rrgi_StateData = 0; 
fake_item.rrgi~Next = r_growth_list ; 
prev_rgi = &fake_item ; 

if (first) 
{ 

/* 

* If this is the first row to be added on this particular scanline, 

* then we have to update the existing contents of those elements 

* at the beginning of the growth list which precede (in coords) the 

* first element of the row. "Updating" involves updating the 

* g6ea*ieesn6net©foih@a@&eraeftinenwe&e Mi@btfehebourfi©n&daUfc©n Sfeigh&s 

* new row. 
V 

rgi = r_growth_list ; 

while (rgi != NULL && *row > rgi- >rrgi_RgnData) 

#ifndef RB_USE_LOOKUP 

rgi->rrgi_StateData = (rgi->rrgi_StateData & RB_CUR_STATE_MASK) | 

(rgi->rrgi_StateData >> RB STATE SIZE) ; 

flelse 

rgi->rrgi_StateData = r_shif t_and_dup (rgi- >rrgi StateData) ; 

#endif 

prev_rgi = rgi; 
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rgi = rgi->rrgi Next; 

) 

) 

else 
{ 

/* 

* This is the second row to be added on this particular scanline. 

* Therefore, we don't need to update the state of the elements 

* preceding (in coords) the first run of the row to be added, as 

* they have already been updated by the first row to be added on 

* this scanline. We simply skip over the unaffected elements.. 
*/ 

rgi = r_growth_list ; 

while (rgi != NULL && *row > rgi->rrgi RgnData) 

{ 

prevjrgi = rgi; 

rgi = rgi->rrgi_Next; 



if (rgi == NULL) 
{ 

/* 

* We've already exhausted the current growth list. Set the start 

* of the next pixel run to be the max. possible and set the state 

* to be 0. 
*/ 

rb_prev_run_state = 0; 

else 
( 

/* 

* We are still within the current growth list bounds. Set up 

* the run info appropriately. 
*/ 

if (rgi == r_growth_list) 
rb_j>rev_run_state ■ 0; 

else 

rb_prev_run_state = prev_rgi- >rrgi_StateData ; 



/* 

* We can now start merging the elements of the row with the remaining 

* elements of the growth list. 
V 

row_on = TRUE; 

while (R_NOT_END OF ROW(*row)) 

( " 

if (rgi == NULL | | *row < rgi->rrgi_RgnData) 
/* 

* This is the only situation in which we actually have to 

* create a new list element. First, we check that we 

* actually have an element in the free list that we 

* can use in the growth list.. 
V 

if (r_free_list == NULL) 
{ 

if ( !r_grow_free_list () ) 
return FALSE; 
i>rev_rgi->rrgi_Next = r_free_list; 
prev_rgi = r_free_list; 
r_free_list = r_f ree_list->rrgi_Next ; 
prev_rgi->rrgi_Next = rgi; 
/* 

* Now, fill in the data.. 
*/ 

prev_rgi->rrgi_RgnData = *row; 
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if (first) 
{ 

/* 

* We are processing the first region. Therefore, we 

* copy the current state of the run to the lowest 

* RB_STATE_SIZE bits. 
*/ 

ffifndef RB_USE_LOOKUP 

prev_rgi->rrgi_StateData = (rb_prev_run_state & RB_CUR_STATE_MASK) | 

(rbprev run state >> RB STATE SIZE) ; 
ttelse " " " 

prev_rgi->rrgi StateData = r shift and dupfrbprev run state]; 
ftendif " ~ 

} 

else 
{ 

/* 

* We are processing the second region. Therefore, the state data 

* has already been copied to the previous state area so we 

* just copy the state. 
*/ 

prev rgi->rrgi StateData = rb prev run state; 
} ~ " " 

/* 

* Now, if the row for the current region is active at this transition, 

* we xor the region mask with the current contents of the new list 

* item. This gives the desired behaviour of making that region active 

* if it is not there already, but turns it off if it is... 
*/ 

i f ( row_on ) 

prev_rgi->rrgi_StateData A = (rgnjnask << RB_STATE SIZE) ; 

/* 

* We now move onto the next row element . 
*/ 

row++ ; 

row_on = ! row_on ; 
continue; 

} 

/* 

* If the current row transition point is equal in x position to the current 

* list item's transition point, we advance the row counter to 

* the next position. 
*/ 

if (*row == rgi->rrgi RgnData) 

{ 

row++; 

row on = ! row_on ; 

) 

/* 

* We update the current list item to deal with the affects of the 
* /current row run. . 

rb_prev_run_state = rgi->rrgi_StateData; 

if (first) 

{ 

Uifndef RB_USE_LOOKUP 

rgi->rrgi_StateData = (rb_prev_run_state & RB_CUR_STATE_MASK) | 

(rb_prev_run_state >> RB_STATE SIZE) ; 

ftelse 

rgi->rrgi_StateData = r_shift_and dup (rb_prev_run_state) ; 

tfendif 

} 

if (!row_on) 

rgi->rrgi_StateData A = (rgn_mask << RB_STATE SIZE) ; 

/* 

* We now move onto the next element in the list.. 
prev_rgi = rgi; 
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rgi = rgi->rrgi Next; 

} 

/* 

* Now, simply update the remainder of the elements in the list.. 
*/ 

if (first) 
( 

while (rgi U NULL) 
{ 

tfifndef RB_USE_LOOKUP 

rgi->rrgi_StateData = (rgi->rrgi_StateData & RB_CUR_S TATE_MAS K ) 

(rgi->rrgi_StateData >> RB_STATE SIZE) ; 

ffelse 

rgi->rrgi StateData = r_shif t_and_dup[rgi->rrgi_StateData] ; 

tfendif 

rgi = rgi->rrgi_Next; 



/* 

* Now copy "fake_item n • s next pointer to r_ growth_list , as it will have 

* changed if something was added to the head of the list.. 
*/ 

r_growth_list = f ake_item. rrgi_Next ; 
/* 

* Update the return pointer to the region data.. 
*/ 

*row_ptr = row; 

/• Everything should now be OK. . 
*/ 

return TRUE; 

} 

ffifdef R_USE_NEW_IMP 
/* 

* r_union_test_table 
* 

* A 16 -int lookup table which when provided with an unsigned char 

* of the following form xxyy, will provide evaluate the key 

* state transition test of the union construction loop. 

* Note that R_STATE_SIZE _must_ be 2 for this lookup table to 

* work. 
V 

int reunion test_table [16) = { 

0, 1, 1, 1, 

1, 0, 0 # 0, 
1, 0, 0, 0, 
1, 0, 0, 0 

}; 

* Reunion 
* 

* This function inits a R_Region structure to represent the union 

* of it's two arguments. 
* 

* Parameters: 

* rgn The R_Region to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
V 

int 

R union 
C 

.R_Region *rgn, 
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R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags; 

union_tot++; 

if ( !BB_intersect_test{&rl->rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 

./* 

* The bounding boxes don't intersect. This means we can do the 

* union very easily, simply by copying data from the two regions. 

* We malloc a new region data array of size rl->rr_RgnDataSize + 

* r2->rr_RgnDataSize - 1. This is the maximum possible size of 

* resulting region. Not all of this memory will be utilised if 

* the two regions being combined have rows with the same y coordinate 

* (R_NEXT IS_Y marker is not duplicated) . 
*/ 

rgn->rr_RgnDataSize = rl->rr_RgnDataSize + r2->rr_RgnDataSize - 1; 
rgn->rr_RgnData = (R_Int *)malloc (rgn->rr_RgnDataSize * 

sizeof (R_Int) ) ; 

if (rgn->rr_RgnData == null) 

{ 

return FALSE; 

) 

/• 

•/Now, check to see if the regions overlap in y. . . 

if (((overlap flag6 & BB INTERSECT OVERLAP Y) ) 
{ - - _ 

/* 

* The regions don't overlap in y. We simply copy one region 

* and then another into the array we malloced. We ensure 

* that rl points to the region with the smallest y coordinate. 
•/ 

if (r2->rr_BBox.Y.Min < rl->rr BBox.Y.Min) 
{ 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp; 

} 

memcpy 
( 

rgn- >rr_RgnData , 
rl - >rr_RgnData , 

(rl->rr_RgnDataSize - l) * sizeof (R_Int) 

) ; 

memcpy 
( 

rgn->rr_RgnData + rl - >rr_RgnDataSi2e - 1, 
r2->rr_RgnData, 

r2->rr_RgnDataSize * sizeof (R Int) 

) ; 

ASSERT ( rgn- >rr__RgnData { rgn - >rr_RgnDataSize - 1] == R_EOR) ; 

else 
{ 

R_Int *rl_tmp; 
R_Int *r2_tmp; 
R_Int *dest; 
R_Int min_row; 
int rl_done; 
int rl_consumed; 
int r2 consumed; 
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int num_written; 
/* 

* The bboxes overlap in y but not in x. We simply go row 

* by row through each region and memcpy the individual rows as 

* appropriate. We ensure that rl points to the region with 

* the smallest x coordinate. 
V 

if (r2->rr_BBox.X.Min < rl->rr_BBox.X .Min) 

{ 

R_Region *tmp; 
tmp = rl; 
rl = r2; 
r2 = tmp; 

) 

rl_dat a rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
dest = rgn->rr_RgnData; 
rgn->rr_RgnDataSize * 0; 
rl_consumed » 0; 
r2_consumed = 0; 

while (*rl dat ! = R_E0R && *r2_dat != R_E0R) 
{ 

ASSERT (*rl_dat == R_NEXT_IS_Y) ; 
ASSERT (*r2~dat == R_NEXT_ISJY) ; 
min_row = min (rl_dat [1] , r2_dat(l)); 
rl_done = FALSE ; 
if (rl_dattlj = = min_row) 

{ 

/* 

* We need to emit rl . We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values . . 
*/ 

rl_tmp = rl_dat + 4 ; 

while (*rl_tmp != R_NEXT_ISJf *rl_tmp != R_E0R) 

rl_tmp++; 
num_written = rl_tmp - rl_dat; 

memcpy(dest, rl_dat, num_written * sizeof (R_Int) ) ; 
dest += num_written; 
rl_consumed += num_written; 
r9ndatr E R9fflDete^$ize num_written; 
rl_done = TRUE ; 

} 

if (r2 dat[l) « min row) 



{ 



/* 

* We need to emit rl . We therefore need to find where 

* the next row (if any) starts. When we do this we 

* recall that a y value _must be followed by at least 

* two x values. If rl ' s current row has already been 

* emitted for this y value, we do _not_ emit the 

* R_NEXT_IS_Y marker or the y value itself. 
*/ 

if (rl done) 
{ 

r2_dat += 2; 

r2_tmp = r2_dat + 2; 

r2_consumed += 2; 

} 

else 

i 

r2_tmp = r2_dat + 4 ; 

) 

while (*r2_tmp != R_NEXT_IS_Y && *r2_tmp != R_E0R) 

r2_tmp++; 
num_written = r2_tmp - r2_dat; 
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memcpy (dest, r2_dat, num_written * sizeof (R_Int) ) ; 

dest += num_written; 

r2_ consumed += num_written; 

rgn->rr_RgnDataSize + = num_written; 

r2_dat = r2_tmp; 

) 

) 

if <*rl_dat != R EOR) 
{ 

/* 

* rl is the last region left standing. We memcpy 

* the remainder of the region (including the 

* R_EOR marker) to the destination. 
*/ 

ASSERT ( r2_consumed r2->rr_RgnDataSize - 1) ; 

memcpy 

( 

dest, 
rl_dat, 

(rl->rr_RgnDataSize - rl_consumed) * sizeof (R_Int) 

• • • ) ; 

*.**. rgn->rr_RgnDataSize +« (rl->rr_RgnDataSize - rl_consumed) ; 

• • else 

. * { 

•••• /* 

* r2 is the last region left standing. We memcpy 
••• * the remainder of the region (including the 

* R EOR marker) to the destination. 
*/ " 

ASSERT (rl_consumed == rl->rr_RgnDataSize - 1) ; 



• • • • 
> • • 

• • • 



memcpy 

• ( 

dest , 



• » • 

• • • 



r2_dat , 

(r2->rr_RgnDataSize - r2_consumed) * sizeof (R Int) 

) ; 

rgn->rrJRgnDataSize += (r2->rr_RgnDataSize - r2_consumed) ; 

ASSERT 
( 

rgn->rr_RgnDatafrgn->rr_RgnDataSize - 1) == R EOR 

) ; 



} 

else 

{ 



R_Int min_row; 

RnfcgnGrowItem degtj_size; 

R_RgnGrowItem *rgi_tail / 

int in_run; 

int done__r 1_ i n_row ; 

union_full++; 



The two regions _do_ overlap in x _and_ y. We therefore have 

to do a bit more work in calculating the union of the two 

regions. We use the a list of RJRgnGrowItem structs to store state 

regarding the currently active regions as we progress through 

the rows of each region. After any rows relevent to a y-coord 

are added to the list, we examine the state of each 

pixel run in the list. If the addition of the row(s) 

for the y-coord have caused a transition to or from 0, then 

the pixel run is emitted. 
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rl_dat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
dest_size = 0; 
/* 

* We are now ready to loop through the data of both regions. 

* We continue building the new region whilst there is data 

* remaining in either of the two regions. 
*/ 

while (*rl_dat ! = R_EOR || *r2_dat ! = R_EOR) 

ASSERT (*rl_dat == R_NEXT_IS_Y || *rl_dat == R_EOR) ; 
ASSERT ( * r2_dat == R_NEXT_IS_Y jj *r2~dat == R EOR); 
if (*rl_dat == R_EOR) 

min_row = r2_dat[l); 
else if (*r2_dat == R_E0R) 

min_row = rl_dat[l); 

else 

min_row = min(rl_dat [1] , r2_dat (1) ) ; 
done_rl_in_row = FALSE; 

if (*rl_dat ! = R EOR && rl dat(l) == min row) 
{ 

/♦ 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if { !R_add_row_to_region_growth_list (&rl_dat, 0xl # TRUE) ) 

return FALSE; 
done_rl_in_row = TRUE; 

} 

if (*r2_dat != R EOR && r2 dat(l) == min row) 
{ 

/* 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
V 

if ( !R_add_row_to_region_growth_list (&r2_dat , 0x2, 
ldone_rl_in_row) ) 
return FALSE; 

)* 

* Now, we generate the output row for the input rows. 
*/ 

if (!r_check rgn buf len(dest size + 2)) 

{ 

return FALSE; 

} 

r_RgnBuf {dest_size++) = R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
in_run = FALSE; 
ft i f nde f R_NEW_I MP_CONSTRUCT ION_LOOP 

for (rgi = r_growth_list ; rgi != NULL; rgi = rgi- >rrgi_Next) 

ftif 0 

if 
( 

rgi->rrgi_StateData > 0 

ScSc 

( 

(rgi->rrgi_StateData & RB CUR STATE MASK) == 0 
II " ' 

(rgi->rrgi_StateData & R8_PREV_STATE_MASK) == 0 

) 

) 

ttelse 

if (r_union_test_table (rgi->rrgi_StateDataJ ) 

tfendif 

{ 

/* 
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.... #e 1S e 



• • • 
• • • 

• • • 



tfendif 



* We have to emit a run here, if we're not already 

* in one . . 
V 

if ( ! in run) 
{ 

if { !r_check_rgn_buf_len(dest_size + 1)) 
return FALSE; 

) 

r_RgnBuf (dest_size++) = rgi->rrgi RgnData; 
in_run = TRUE ; 



} 



else 

{ 

if (in run) 



{ 



) 

iy in_run m FALSE; 

/* 

* N °t efficient, get rid of it 
• • */ 

if (rgi->rrgi_Next == NULL) 
rgi_tail = rgi; 



/* 

* We've come to the end of a run. We output the next 

element to end it. 
V 

if ( !r_check_rgn_buf_len(dest_size + 1)) 
} return FALSE; 

r_RgnBuf [dest_size++] = rgi->rrgi_RgnData; 



) 

rgi = r_growth_list; 
rgi_tail = rgi; 

while (rgi != NULL && ! r_union_teet Jzable [rgi->rrgi StateData] ) 

rgi = rgi->rrgi_Next; 
while (rgi != NULL) 

if ( !r_check_rgn_buf_len{dest_size + 2)) 

return FALSE; 
r_RgnBuf (dest_size++) = rgi->rrgi_RgnData ; 
do 

{ 

rgi = rgi->rrgi_Next; 

} while (rgi u NULL && r_union_test_table [rgi->rrgi StateData) ) • 
rgi_tail = rgi; 

r_RgnBuf (dest_size++) = rgi - >rrgi_RgnData ; 
do 

( 

rgi = rgi->rrgi_Next ; 
) while (rgi ! = NULL && ■ r_union_test Jiable [rgi - >rrgi__StateData] ) ; 

if (r_RgnBuf [dest_size - 2) == R_NEXT_IS_Y) 
/* 

* We didn't output anything for these input rows. Rewind.. 
*/ 

dest_size -= 2; 

) 

» 

» Now, we've completed using the growth list for constructing this 
* region. Therefore, we add it to the front of the free list, to 
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* be re-used later. 
*/ 

ffifdef RJ*EW_IMP_CONSTRUCTION_LOOP 

while lrgi_tail->rrgi_Next ! = NULL) 
rgi_tail = rgi_tail->rrgi_Next ; 

tfendif 

rgi_tail->rrgi_Next = r_free_list; 
r_free_list = r_growth_list ; 
r_growth_list = NULL; 
/* 

* We've completed constructing the data for the region. We 

* make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int Mmalloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn->rr_RgnData == NULL) 

{ 

return FALSE; 

} 

memcpy (rgn->rr_RgnData, r_RgnBuf, (dest_size - 1) * sizeof (R_Int )) ; 
rgn->rr_RgnData (dest_size - 1) = R_EOR; 
rgn->rr_RgnDataSize = dest_size; 
ASSERT (rgn->rr RgnDataSize >= 9) ; 

} 

/* 

* We now do a bounding box union of the two component bboxes and place 

* the result in the new region. 
*/ 

BB_union(&rl->rr_BBox, &r2->rr_BBox, irgn->rr_BBox) ; 
/* 

* Done ! We can get out . . 
*/ 

return TRUE; 

} 

* R_union_equals 
* 

* ffeifinloncfe20© 8 bQaie§UireAmgiflmen6sr©sCltuBieQFn6a tKPeiOperation. Ie 
* 

* Parameters: 

* rl A pointer to an R_Region. This represents 

* the first half of the union, and is also used to return 

* the eventual result. 

* r2 A pointer to an R_Region. This represents the second 

* half of the union. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_union equals 
( 

R_Region *rl, 
R_Region *r2 



R_Region new_rgn; 

If (rl->rr_RgnData = = NULL) 

return R_init_region_with_region (rl , r2) ; 
if (! Reunion (&new_rgn, rl, r2)) 

return FALSE; 
R_empty_region ( rl ) ; 
*rl = new_rgn; 
return TRUE ; 
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* r_intersection_test_table 
* 

* A 16 -int lookup table which when provided with an unsigned char 

* of the following form xxyy, will provide evaluate the key 

* state transition test of the intersection construction loop. 

* Note that R_STATE_SIZE _must_ be 2 for this lookup table to 

* work. 
*/ 

int r_intersection_test_table [16] = { 

0, 0, 0, l, 
0, 0, 0, 1, 

0, 0, 0, 1, 

1, 1, 1, o 

}; 

/* 

* R_intersection 

* This function inits a R_Region structure to represent the intersection 

* of it's two arguments. 
* 

* Parameteji^v A R_Region ptr to the R_Region structure to be initialised. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_intersection 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



R_Int *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags; 



int_tot++; 

rgn->rr_RgnData = NULL; 

if ( !BB_intersect_test (&rl->rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 



* The bounding boxes don't intersect. This means that the regions 

* don't intersect. Therefore, we simply set rgn->rr_RgnData to NULL 



(signifying an empty region) and get out.. 



return TRUE; 

} 

R_Int 
int 

R_RgnGrowItem 

R_RgnGrowItem 

int 

int 

IntXYMinMax 
int_full++ ; 



mm_row; 
dest_size; 
*rgi ; 

*rgi_tail ; 
in__run; 

done_rl_in_row ; 
new bbox; 



The two regions _do_ overlap in x _and y. We therefore have 
to do a bit more work in calculating the intersection of the two 
regions. We use the R_RegionBuilder struct to store state 
regarding the currently active regions as we progress through 
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* the rows of each region. After any rows relevent to a y-coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row(s) 

* for the y-coord have caused a transition to or from 0x3, then 

* the pixel run is emitted. 
V 

/* 

* Initialise the new_bbox structure for determining the new bounding box. 
*/ 

new_bbox.X.Min = R_INT_MAX_VALUE; 
new_bbox. Y.Min = R_INT~MAX_VALUE 
new_bbox. X.Max = R_INT_MIN_VALUE 
new_bpox. Y.Max = R_INT_MIN_VALUE 

/* 

* The next thing we do is ensure the current region builder is empty, 

* and set up pointers into the region data of the two regions. 
*/ 

rldat = rl->rr_RgnData; 
r2_dat = r2->rr_RgnData; 
dest_size = 0; 
/* 

* We are now ready to loop through the data from both regions. Notice 

* that we only keep looping whilst _both_ regions have some data left 

* to give. As soon as either of the region's data has been exhausted, 

* then we stop as the intersection region has already been calculated 

* and is sitting in the rgn_buf. 
V 

while (*rl_dat != R_E0R *r2_dat != R_E0R) 
{ ASSERT (*rl_dat == R_NEXT_IS_Y || *rl_dat =«= R_EOR) ; 
ASSERT (*r2~dat == R_NEXT_IS_Y || *r2_dat == R_EOR) ; 
If (*rl_dat == R_EOR) 

min_row = r2_dat[l); 
else if (*r2_dat == R_E0R) 
min_row = rl_dat[l); 

else 

min_row = min(rl_dat [1) , r2_dat[l]); 
• ••• done_rl_in_row = FALSE; 

if (*rl dat != R EOR && rl dat(l) = * min row) 

1 /." 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
V 

if ( !R_add_row_to_region_growth_list (&rl_dat, 0x1, TRUE) ) 

return FALSE; 
done rl in row = TRUE; 

) 

if (*r2 dat != R EOR && r2 dat(l) == min row) 



{ 



) 

/* 



* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if ( !R_add_row_to__region_growth_list (&r2_dat , 0x2, ! done_rl_in_row) ) 
return FALSE; 



Now, we generate the output row for the input rows. 
*/ 

if ( !r_check_rgn_buf_len(dest_size ♦ 2)) 
return FALSE; 

} 

r_RgnBuf [dest_size+ + ] = R_NEXT_IS_Y; 
r_RgnBuf (dest_size++) = min_row; 
in_run = FALSE; 
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tfifndef R_NEW_IMP_CONSTRUCTION_LOOP 

for {rgi = r_growth_list ; rgi ! = NULL; rgi = rgi->rrgi_Next ) 
( 



ttif 0 



Helse 
ttendif 



• • 

• • • * 

• • • 



• • • • 

• • • 

• ••• 

• • • # 



to end it. 



Uelse 



) 



if 
( 

rgi->rrgi_StateData != (3 | (3 « RB_STATE_SIZE) ) 

&& 

( 

(rgi->rrgi_StateData & RB_ P RE V_S TAT E_MAS K ) == 3 
II 

(rgi->rrgi_StateData & RB_CUR_STATE_MASK) = = 

(3 << RB_STATE_SIZE) 

) 

) 

if (r_intersection_test_table (rgi->rrgi_StateData) ) 
{ 

/* 

* we have to emit a run here, if we're not already 

* in one . . 
*/ 

if (!in_run) 

( 

if ( !r_check_rgn_buf_len(dest_size + l)) 

( 

return FALSE; 

} 

r_RgnBuf [dest_size++l = rgi->rrgi_RgnData ; 
in_run = TRUE; 

new_bbox.X.Min = min(new_bbox.x.Min, rgi- >rrgi_RgnData) ; 

) 

} 

else 

{ 

if (in_run) 

{ 

/* 

* We've come to the end of a run. We output the next element 
*/ 

if (!r_check rgn buf_len (dest_size + 1) ) 
{ 

return FALSE; 

} 

r_RgnBuf [dest_size++l = rgi->rrgi_RgnData ; 

new bbox. X.Max = max(new_bbox.X .Max, rgi->rrgi_RgnData) ; 

) 

inrun = FALSE ; 

) 

/* 

* Not efficient, get rid of it.. 
*/ 

if (rgi->rrgi_Next == NULL) 
rgi_tail = rgi; 



rgi = r_growth_list ; 
rgi_tail = rgi; 

while r^ttgi rgiMftrVg4&NeRt*ntersection_test_table (rgi- >rrgi_StateData) ) 

while (rgi ! = NULL) 

{ 

if ( !r_check_rgn_buf_len (dest_size ♦ 2)) 

return FALSE; 
r_RgnBuf (dest_size++J = rgi->rrgi_RgnData; 
new_bbox.X.Min = min(new_bbox.X.Min, rgi->rrgi_RgnData) ; 
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do 
{ 

rgi = rgi->rrgi_Next ; 
} while (rgi != NULL && r_intersection_test_table (rgi- >rrgi_StateData) ) 
rgi_tail = rgi; 

r_RgnBuf [dest_size++] = rgi->rrgi_RgnData; 
new bbox. X.Max = max(new_bbox. X.Max, rgi->rrgi_RgnData) ; 
do ~ 
{ 

rgi = rgi->rrgi_Next; 
} while (rgi != NULL I r_intersection_test_table (rgi- 
>rrgi_StateData] ) ; 

} 

#endif 

if (r_RgnBuf [dest size - 2} == R_NEXT_ISJO 
{ 

/* 

* We didn't output anything for these input rows. Rewind.. 
*/ _ 

} dest size -= 2; 
else 

{ 

if (min_row < new_bbox. Y.Min) 
new_bbox. Y.Min = min_row; 
else if (min_row > new_bbox. Y.Max) 
new bbox. Y.Max = min_row; 

} 

/* 

* Now, we've completed using the growth list for constructing this 

* region. Therefore, we add it to the front of the free list, to 

* be re-used later. 
*/ 

ffifdef R_NEW_IMP_CONSTRUCTION_LOOP 

while (rgi_tail->rrgi_Next != NULL) 
rgi_tail = rgi_tail->rrgi_Next ; 

#endif 

• rgi_tail->rrgi_Next = r_free_list; 

r_free_list = r_growth_list ; 
r_growth_list = NULL; 
/* 

* We've completed constructing the data for the region. Firstly 

* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0. If it isn't we simply free the 

* region we created and get out, as the regions don't really 

* intersect, in spite of their intersecting bounding boxes. 
*/ 

if (dest_size == 0) 

{ 

return TRUE; 

} 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
V 

rgn->rr_RgnData « (R_Int * ) malloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn- >rr_RgnData == NULL) 

{ 

return FALSE ; 

} 

memcpy (rgn->rr_RgnData, r_RgnBuf, (dest_size - 1) * sizeof (R_Int) ) ; 
rgn->rr_RgnData (dest_size - 1) = R_EOR; 
rgn->rr_RgnDataSize «= dest_size; 
ASSERT(rgn->rr_RgnDataSize >= 9) ; 
/* 

* Now, copy across the bounding box. . Before we do this, we subtract 

* 1 from X.Max and Y.Max because of the region format. 



• • • • 

• * 



• • • • 
» • • 

• • • 

• ••• 



» • • 
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*/ 

newjbbox . X . Max- - ; 
new_bbox . Y . Max- - ; 
rgn->rr_BBox = new_bbox; 
/* 

* Done ! We can get out . 
*/ 

return TRUE; 



) 

/* 

* rdif f erence_test_table 

* A 16 -int lookup table which when provided with an unsigned char 

* of the following form xxyy, will provide evaluate the key 

* state transition test of the difference construction loop. 

* Note that R_STATE_SIZE _must_ be 2 for this lookup table to 

* work. 
V 

int r_dif f erence_test_table (16] = { 

0, 1, 0, 0, 

1, 0, 1, 1, 
0, 1, 0, 0, 
0, 1, 0, 0 

); 

/* 

* R__dif f erence 
* 

* This function inits a R_Region structure to represent the difference of 

* it's two arguments. It essentially calculates rl - r2 
* 

* Parameters: 

* rgn A R_Region ptr representing the R_Region to be inited. 

* rl A R_Region ptr representing the first region. 

* r2 A R_Region ptr representing the second region. 

* Returns 

* TRUE on success, FALSE on failure. 
*/ 

int 

R_dif f erence 
( 

R_Region *rgn, 
R_Region *rl, 
R_Region *r2 



Rjnt *rl_dat; 
R_Int *r2_dat; 
int overlap_f lags; 



diff_tOt++; 

rgn->rr_RgnData = NULL; 

if ( !BB_intersect_test (&rl- >rr_BBox, &r2->rr_BBox, &overlap_f lags) ) 
{ 

/* 

* The bounding boxes don't intersect. This means that rl - r2 

* simply equals rl . We make a copy of the relevant bits and get out. 
*/ 

rgn->rr_BBox = rl->rr_BBox; 
rgn->rr_RgnDataSize = rl->rr_RgnDataSize; 

rgn->rr_RgnData = (R_Int Mmalloc (rl->rr_RgnDataSize * sizeof (RJnt ) ) 
if <rgn->rr_RgnData == NULL) 

return FALSE; 

) 
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memcpy 
( 

rgn- >rr_RgnData , 
rl->rr_RgnData, 

rl->rr_RgnDataSize * sizeof (R_Int ) 

); 

return TRUE; 

) 

R_Int min_row; 
int dest_size; 
R_RgnGrowI tern * rg i ; 
R_RgnGrowitem *rgi_tail ; 
int in_run; 
int done_ rl_in_row; 

unsigned char m_high; 
unsigned char m_low; 
IntXYMi nMax ne w_bbox ,- 

diff_full++; 



* The two regions _do_ overlap in x _and y. We therefore have 

* to do a bit more work in calculating the difference of the two 

* regions. We use the R_RegionBuilder struct to store state 

* regarding the currently active regions as we progress through 

* the rows of each region. After any rows relevent to a y-coord 

* are added to the region builder, we examine the state of each 

* pixel run in the region builder. If the addition of the row(s) 

* for the y-coord have caused the following transitions - 

rl -> 0 

0 -> r2 

* rl + r2 -> r2 

* r2 -> rl + r2 

* ..then the relevent runs are emitted. Firstly, though, 

* we ensure the current region builder is empty, 

* and set up pointers into the region data of the two regions. 
*/ 

rl_dat « rl->rr_RgnData; 
r2_dat = r2- >rr_RgnData ; 
dest_size = 0; 

/* 

* Initialise the new_bbox structure for determining the new bounding box. 
*/ 

new_bbox.X.Min = 32767; 
new_bbox.Y.Min * 32767; 
new_bbox. X.Max « -32768; 
new_bbox. Y.Max = -32768; 

/♦ 

* We are now ready to loop through the data from both regions. Notice 

* fcfcafc tiStenl? bofiPumeflpioBeWhiiettrinfe^eidfltamaafesten^inareWhen 

* irrelevant. 
V 

while (*rl dat != R EOR) 
{ 

ASSERT (*rl_dat == R_NEXT_IS_Y || *rl_dat == R_EOR) ; 
ASSERT (*r2_dat == R_NEXT_IS_Y || *r2_dat == R_EOR) ; 
if (*rl_dat == R_E0R) 

min_row = r2_dat(l); 
else if (*r2_dat =*= R_E0R) 

min_row = rl_datll] ; 

else 

min_row = min (rl_dat (1) , r2_dat[l)); 
done_rl_in_row = FALSE; 

if (*rl~dat R EOR && rl dat[l] == min row) 



• • • 



• • • • 

■ • • 

• • ft ft 

• • • 



• • • • 

ft ft ft 

• • • 



• **• • tfelse 



flendif 
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* The first region is active on this y coord. We add this 

* row to the current region builder. 
*/ 

if (!R_add_row_to_region_growth_list(&rl_dat, 0x1, TRUE) ) 

return FALSE; 
done rl in row = TRUE; 

) 

if (*r2_dat 1= R_EOR && r2_dat(l] == minjrow) 
/• 

* The first region is active on this y coord. We add this 

* row to the current region builder. 
V 

if <!R_add_row_to_region_growth_list(&r2 dat, 0x2, Idone rl in row)) 
return FALSE; " - - - 

/* 

*^Now, we generate the output row for the input rows, 
if { !r_check_rgn_buf_len(dest_size + 2)) 
return FALSE; 

} 

r_RgnBuf [dest_size++J = R_NEXT IS_Y; 
r_RgnBuf [dest_size++] = min_row; 
in_run = FALSE; 
tfifndef R_NEW_IMP_CONSTRUCTION_LO0P 

for (rgi = r_growth_list ; rgi NULL; rgi « rgi->rrgi_Next) 

mjiigh = (rgi->rrgi_StateData & RB__CUR_STATE_MAS K ) » RB STATE SIZE- 
m_low = rgi->rrgi_StateData & RB_PREV_STATE MASK; 
if ~ " 

( 

( 

(m_low != 1 && m high == 1) 
II 

(m_low == l && m_high ! = l) 

) 

if (r_difference_test_table [rgi->rrgi_StateData] ) 
{ 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
V 

if ( ! in run) 
{ 

if (!r_check_rgn_buf_len(dest_size + l)) 

return FALSE; 

i"_RgnBuf [dest_size++] = rgi->rrgi_RgnData ; 
in_run = TRUE; 

^ new_bbox.X.Min = min (new_bbox. X . Min, rgi - >rrgi_RgnData) ; 

) 

else 

{ 

if (in_run) 



#if 0 



{ 



/* 

* We've come to the end of a run. We output the next element 

to end it. 
*/ 
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if ( ! r_check_rgn_buf_len (dest_size ♦ 1)) 

{ 

return FALSE; 

} 

r_RgnBuf (dest_size++) = rgi->rrgi_RgnData; 

new_bbox . X . Max = max (new_bbox.X .Max, rgi- >rrgi_RgnData) ; 

in_run = FALSE ; 

} 

/* 

* Not efficient, get rid of it.. 

V 

if (rgi->rrgi_Next == NULL) 
rgi_tail = rgi; 

) 

ttelse 

rgi = r_growth_list; 
rgi_tail = rgi; 

while (rgi 1= NULL && ! r_dif f erence_test_table {rgi- >rrgi_StateData] ) 

rgi = rgi->rrgi_Next ; 
while (rgi ! = NULL) 
{ 

if ( !r_check_rgn_buf_len(dest_size + 2)) 

return FALSE; 
r_RgnBuf (dest_size++) = rgi->rrgi_RgnData; 
new_bbox.X .Min = min (new_bbox.X .Min, rgi- >rrgi_RgnData) ; 
do " 

{ 

rgi = rgi->rrgi_Next ; 
} while (rgi != NULL && r_dif f erence_test_table [rgi->rrgi_StateData] ) ; 
rgi_tail = rgi; 

r_RgnBuf [dest_size++) = rgi- >rrgi_RgnData ; 

new_bbox . X . Max = max (new_bbox. X .Max, rgi- >rrgi_RgnData) ; 

do 

( 

rgi = rgi->rrgi_Next ; 
) while (rgi != NULL ! r_dif f erence_test_table frgi->rrgi_StateData] ) 

tfendif 

if (r_RgnBuf [dest size - 2] == R NEXT IS Y) 
{ " " " ~~ 

/* We didn't output anything for these input rows. Rewind.. 
*/ 

dest_size - = 2; 

) 

else 
{ 

if (min_row < new_bbox. Y.Min) 

new_bbox . Y . Min = min_row; 
else if (min_row > new_bbox . Y. Max) 

new bbox. Y.Max = min row; 

} 

} 

/* 

* Now, we've completed using the growth list for constructing this 

* region. Therefore, we add it to the front of the free list, to 

* be re-used later. 
♦/ 

# i f de f R_NEW_ I MP_CONSTRUCT ION_LOOP 

while (rgi_tail->rrgi_Next != NULL) 
rgi_tail = rgi_tail- >rrgi_Next ; 

ttendif 

rgi_tail->rrgi_Next = r_free_list; 
r_free_list = r_growth_l ist ; 
r_growth_list = NULL; 
/* 

* We've completed constructing the data for the region. Firstly 
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* we check to see if we've emitted anything at all. If we have 

* then dest_size must be > 0. If it isn't we simply free the 

* region we created and get out, as r2 - rl must be empty. 
*/ 

if (dest size == 0) 
{ 

return TRUE; 

) 

/* 

* We make a copy the constructed data from the permanent buffer to 

* an exactly fitting buffer. 
*/ 

rgn->rr_RgnData = (R_Int * ) malloc (++dest_size * sizeof (R_Int) ) ; 
if (rgn->rr_RgnData == NULL) 

{ 

return FALSE; 

} 

memcpy (rgn->rr_RgnData, r_RgnBuf, (dest_size - 1) * sizeof (R_Int) ) ; 

rgn->rr_RgnData(dest_size - 1) = R_E0R ; 

rgn->rr_RgnDataSize = dest_size,- 

ASSERT ( rgn- >rr_RgnDataSize >= 9) ; 

/* 

* Now, copy across the bounding box. . 
*/ 

rgn->rr_BBox = new_bbox; 
/* 

* Done! We can get out.. 
*/ 

return TRUE; 

} 

Hendif /* R_USE_NEW_IMP */ 
/* 

* R_compare 
* 

* This function compares two regions and determines if they are the same 

* Parameters: 

* rgnl The first R_Region. 

* rgn2 The second R_Region. 

* Returns: 

* TRUE if they are the same, FALSE if they aren't. 
*/ 

int 

R_compare 

( R_Region *rgnl, 
R_Region *rgn2 

) 
{ 

/* 

* If their region data sizes don't agree, then they aren't the same 
*/ 

if {rgnl->rr_RgnDataSize != rgn2- >rr_RgnDataSize) 
return FALSE ; 

if 
( 

memcmp 
( 

rgnl - >rr_RgnData , 
rgn2 - >rr_RgnData , 

rgnl->rr_RgnDataSize * sizeof (R_Int ) 

) 



return TRUE; 
return FALSE; 
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} 

/* 

* r_check_rect_buf_len 
* 

* This function checks to see if the static rectangle buffer is large 

* enough, if it isn't then it is reallocated to make it large enough. 
* 

* Parameters: 

* size The required size of the r_RectBuf array. 

* Returns: 

* TRUE on success, FALSE on failure. 
*/ 

static int 

r_check_rect_buf_len 
( 

int size 

) 
{ 

ASSERT (size >= 0) ; 

if (size > r_RectBufSize) 

{ 

int new_buf_size; 
IntXYMinMax *new_buf; 

new_buf_size = max(size, r_RectBuf Size * 2) ; 
new_buf = (IntXYMinMax *)malloc 

(new_buf_size * sizeof (IntXYMinMax) 

) ; 

if (new_buf == NULL) 

return FALSE; 
if (r_RectBuf != NULL) 
{ 

memcpy (new_buf , r_RectBuf, r_RectBuf Size * sizeof (IntXYMinMax) ) ; 
f ree (r_RectBuf ) ; 

) 

r_RectBuf = new_buf; 
r_RectBuf Size = new_bufsize; 

} 

return TRUE; 



fndef R_USE_NEW_IMP 
R_rects_f rom_region 

This function returns a group of non- overlapping rectangles which 
together constitute the region. The group of rectangles returned is 
eergeofciys©Q5eQPAimalrea8pfeb£f fenatoiensuraetfebe &i&&g&QnB&q&4eedst&ucture 

make the rectangles produced more optimal. 

Parameters : 

rgn The region from which a rectangle array is required, 

rects A pointer to a pointer to a IntXYMinMax structure. Used 

to return the array. 
num_rects A pointer to an int. Used to return the number of 

elements in the array. 
static_ok This boolean arg is passed as TRUE if a pointer to 

the r_RectBuf is sufficient. This is TRUE if usefulness of 
the rectangle data obtained ends before the next call to 
R_rects_f rom_region (for any region) . FALSE is passed if 
a newly malloced copy is required. Basically is TRUE is 
passed the pointer returned must _not_ be freed. 

Returns : 

TRUE on success, FALSE on failure. 

'/ 
int 

R_rect s_f rom_region 
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R_Region 

IntXYMinMax 

int 

int 



*rgn, 
**rects, 
*num_rects , 
static ok 



R_Int 


*rgn_data; 


int 


dest_index; 


int 


prev_y; 


int 


prev_x; 


unsigned char 


*rgn_bld_stat; 


R_Int 


*rgn_bld_dat; 


int 


i; 


int 


in_run; 


/* 




* Give "nice" 


defaults for return 


*/ 





♦rectS = NULL; 
*num_rects = 0; 
/* 

* We grab a pointer to the region data for the region and ensure 

* that the current region builder is empty.. 
*/ 

rgn_data = rgn«>rr_RgnData; 
if (rgn_data = = NULL) 
/* 

* This is an empty region.. Get out.. 
V 

return TRUE ; 
ASSERT ( *rgn_data == R_NEXT_IS_Y) ; 
R_CurRB->rrb_Nels = 0; 
/* 

* HeoBgdtbfceyfiesfedreS ofii&hgir§gi©awto the region builder. We also 
*/ 

prev_y = rgn_data[l); 

if ( ! R_add_row_to_region_builder (&rgn_data , 0x1 , TRUE) ) 

return FALSE; 
ASSERT (*rgn_dat a == R_NEXT_IS_Y) ; 
ASSERT (*rgn_dat a != R~E0R) ; 
/* 

* We are now in a position to loop through the data of the region. 

* We continue until the region data runs out. Basically, we output 

* the runs in the current region builder out as rectangles. Using 

* x-coords from the region builder and y coords of the rows. Then, 

* we add then next row to the region builder. 
*/ 

dest_index = 0; 

while (*rgn data != R EOR) 

{ 

ASSERT (*rgn_data == R_NEXT_IS_Y) ; 

rgn_bld_stat = R_CurRB- >rrb_StateData ; 
rgn_bld_dat = R_CurRB- >rrb_RgnData ; 
in_run = FALSE; 

for (i = R_CurRB->rrb_Nels; i > 0; i - - ) 

I 

if ( (*rgn_bld_stat & RB_CUR_STATE_MASK) > 0) 
{ 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
*/ 

if (!in_run) 
{ 

prev_x = *rgn_bld_dat; 
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in run = TRUE; 



else 

{ 

if (in_run) 
{ 

/* 

* We've come to the end of a run. We output the rectangle 

* right here. . 
*/ 

if ( ! r_check_rect_buf _len (dest_index + 1)) 

return FALSE; 
r_RectBuf {dest_index] .X.Min = prev_x; 
r_RectBuf [dest_indexj .Y.Min = prev_y ; 
r_RectBuf Idest_index] .X.Max = *rgn_bld_dat - 1; 
r_RectBuf [dest_index++) .Y.Max = rgn_data(l) - 1; 

) 

in_run = FALSE ; 

) 

rgn_bld_stat++ ; 
rgn_bld_dat++; 

} 

/* 

* Now, we advance onto the next row. . 
•/ 

prev_y = rgn_data[l); 

if ( !R_add_row_to_region_builder Urgn_data, 0x1 , TRUE) ) 
} return FALSE; 

/* 

* Ok, we have the array of rectangles sitting around. If static__ok 

* is TRUE then we simply set the return pointers and get out. 

* Otherwise, we need to malloc a copy of the r_RectBuf . 
*/ 

*num_rects = dest_index; 
if (static_ok) 

{ 

♦rects = r_RectBuf; 

) 

else 

{ 

*rects b (intXYMinMax *) malloc (dest_index * sizeof ( IntXYMinMax) ) ; 
if (*rects « NULL) 
return FALSE; 

memcpy (*rects, r_RectBuf, dest_index * sizeof (IntXYMinMax) ) ; 

• } 

return TRUE; 

se 

R_rec t s_f rom_reg ion 

This function returns a group of non-overlapping rectangles which 
together constitute the region. The group of rectangles returned is 
currently non-optimal as the function uses the R_RegionBuilder structure 
to store state. A more specific data structure will be required to 
make the rectangles produced more optimal. 

Parameters : 

rgn The region from which a rectangle array is required, 

rects A pointer to a pointer to a IntXYMinMax structure. Used 

to return the array, 
num rects A pointer to an int. Used to return the number of 

elements in the array. 
static_ok This boolean arg is passed as TRUE if a pointer to 

the r_RectBuf is sufficient. This is TRUE if usefulness of 

the rectangle data obtained ends before the next call to 
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* R_rects_f rom_region (for any region) . FALSE is passed if 

* a newly malloced copy is required. Basically is TRUE is 

* passed the pointer returned must _not_ be freed. 

* Returns: 

* TRUE on success, FALSE on failure. 
V 

int 

R_rec t s_f rom_region 
( 

R_Region *rgn, 

IntXYMinMax **rects, 

int *num_rects, 

int static ok 



R_Int *rgn_data; 

int dest_index; 

R_RgnGrowItem *rgi; 

R_RgnGrowItem *rgi_tail; 

int prev_y; 

int prev_x; 

int in_run; 

/* 

* Give "nice" defaults for return stuff in cause we fail.. 
*/ 

*rects = NULL; 
*num_rects = 0; 
/* 

* We grab a pointer to the region data for the region and ensure 

* that the current region builder is empty.. 
V 

rgn_data = rgn->rr_RgnData; 
if (rgn_data == NULL) 
/* 

* This is an empty region.. Get out.. 
*/ 

return TRUE; 
ASSERT ( *rgn data == R NEXT IS Y) ; 
/* 

* We add the first row of the region- to the region builder. We also 
♦/store the y-coord of this first row. 

prev_y = rgn_data{l); 

if ( !R__add_row_to_region_growth_list (&rgn_data, 0x1, TRUE) ) 

return FALSE; 
ASSERT <*rgn_data == R_NEXT_IS_Y) ; 
ASSERT (*rgn~dat a != R_E0R) ; 
/* 

* We are now in a position to loop through the data of the region. 

* We continue until the region data runs out. Basically, we output 

* the runs in the current region builder out as rectangles. Using 

* x-coords from the region builder and y coords of the rows. Then, 

* we add then next row to the region builder. 
V 

dest_index = 0; 

while (*rgn data != R EOR) 

{ 

ASSERT (*rgn_data == R_NEXT_IS_Y) ; 
in_run = FALSE; 

for (rgi = r_growth_list ; rgi != NULL; rgi = rgi->rrgi_Next) 

if ((rgi->rrgi StateData & RB_CUR STATE MASK) > 0) 
{ ~ ~ 

/* 

* We have to emit a run here, if we're not already 

* in one . . 
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if (!in_run) 

{ 

prev_x = rgi->rrgi_RgnData; 
in_run = TRUE ; 

) 

} 

else 

{ 

if (in_run) 
{ 

/* 

* We've come to the end of a run. We output the rectangle 

* right here. . 
*/ 

if ( ir_check_rect_buf_len(dest_index + 1)) 

return FALSE; 
r_RectBuf ldest_index] .X.Min = prev_x; 
r_RectBuf [dest_index] .Y.Min = prev_y ; 
r_RectBuf (dest_indexl .X.Max = rgi->rrgi_RgnData - 1; 
r_RectBuf (dest_index++) .Y.Max = rgn_data(l) - 1; 

} 

in_run = FALSE; 

) 

/* 

* Not efficient, get rid of it.. 
•/ 

if (r9i->rrgi_Next == NULL) 
rgi_tail = rgi; 

) 

* Now, we advance onto the next row.. 
V 

prev_y = rgn_data[l]; 

if ( ! R_add_row_to_region_growth_list (&rgn_data , 0x1 , TRUE) ) 
return FALSE; 

} 

/* 

* Now, we've completed using the growth list for constructing the 

* rect list. Therefore, we add it to the front of the free list, to 

* be re-used later. 
*/ 

rgi_tail->rrgi_Next = r_free_list; 
r_free_list = r_growth_list ; 
r_growth_list = NULL; 
/* 

* Ok, we have the array of rectangles sitting around. If static_ok 

* is TRUE then we simply set the return pointers and get out. 

* Otherwise, we need to malloc a copy of the r_RectBuf . 
*/ 

*num_rects = dest_index; 
if (static_ok) 

{ 

♦rects = r_RectBuf; 

> 

else 
( 

*rects = (IntXYMinMax *) malloc (dest_index * sizeof ( IntXYMinMax) ) ; 
if (*rects == NULL) 
return FALSE ; 

memcpy (*rects, r_RectBuf, dest_index * sizeof (IntXYMinMax) ) ; 

} 

return TRUE; 
ttendif /* R_USE_NEW_IMP */ 
/* 

* R_translate_region 
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* This function simply translates a region by the delta provided. 
# 

* Parameters: 

* rgn A ptr to the R_Region to be translated. 

* .delta An IntXY ptr representing the amount to translate 

* in x and y. 

* Returns: 

* Nothing . 
*/ 

void 

R_t r an s 1 a t e_r eg ion 
( 

R_Region *rgn, 
IntXY *delta 

) 
{ 

R_Int *rgn_data; 

BB_translate(&rgn->rr_BBox, delta) ; 
rgn_data = rgn- >rr_RgnData ; 

for (int i = 0; i < rgn->rr_RgnDataSize - 1; i++) 

( 

if (rgn_data lij == R_NEXT_IS_Y) 
{ 

i++; 

rgn_data(i} += + delta->Y; 
continue; 

} 

rgn_data[i] += delta- >X; 

} 

} 

/• 

* R_output_ region_as_debug_string 
* 

* This function simply outputs a region's data using the debug string 

* functionality. 
* 

* Parameters: 

* rgn_name A string used to output a user-defined name for the 

* region. 

* rgn The region to be output. 

* Returns: 

* Nothing. 
V 

void 

R_output_region_as_debug_string 
( 

char *rgn_name, 
R_Region *rgn 

) 
{ 

char buffer (128) ; 
int index; 
int line_len; 

sprintf (buf f er, "\n+Rgn : %s\n", rgn_name) ; 
OutputDebugString (buf f er) ; 
if (rgn == NULL) 
{ 

sprintf (buf fer, "+ End %s (Empty)\n n , rgn_name) ; 

OutputDebugString (buffer) ; 
return; 

) 

sprintf 
( 

buffer, 

BBox: (%d, %d, %d, %d)\n", 



- 107- 

rgn- >rr_BBox . X . Min , 
rgn- >rr_BBox . Y . Min , 
rgn- >rr_BBox . X . Max, 
rgn - >rr_BBox . Y . Max 

); 

OutputDebugString (buffer) ; 

sprintf (buffer, Nels: %d\n°, rgn->rr_RgnDataSize) ; 

OutputDebugString (buffer) ; 

sprintf (buffer, n + Data: . .."); 

OutputDebugString (buffer) ; 

for (index = 0; index < rgn->rr_RgnDataSize; index++) 
{ 

if (rgn- >rr_RgnData (index) == R_NEXT_IS_Y) 
( 

sprintf (buffer, M \n| Y:%3d--> u , rgn- >rr_RgnData (++index) ) 

line_len = strlen (buf f er) ; 
OutputDebugString (buff er) ; 

else if ( rgn- >rr_RgnData( index) == R_EOR) 

{ 

sprintf {buffer. -\n+ End%s\n°, rgn_name) ; 

OutputDebugString (buffer) ; 

J 

else 
{ 

:* #### sprintf (buf fer, n %3d, rgn- >rr_RgnData (index) ) ; 

if (strlen(buf fer) + line_len > 80) 
{ 

OutputDebugString ( "\n | " ) ; 

line_len = strlen( a \nj "); 

) 

OutputDebugString (buffer) ; 
line_len += strlen (buf fer) ; 

} 

} 

) 

ttdefine NUM_ITERATIONS 200 
int 

R_test_new_region_arithmetic ( ) 

{ 



• • 

» • • 

• • • 



• • • • 

» • • 

• • • 



R_Region 


rgnl ; 


R_Region 


rgn2 ; 


R_Region 


rgn3 ; 


R_Region 


rgn4 ; 


R_Region 


rgn5 ; 


R_Region 


rgn6 ; 


IntXYMinMax 


rect; 


int 


i; 


IntXY 


delta; 


char 


buf [256] ; 


unsigned long 


ticks_new; 


unsigned long 


ticks_old; 



«if 0 

/* 

* Union Test . 
V 

ticks_new = GetTickCount ( ) ; 
rect. X. Min = 50; 
rect. Y. Min * 50; 
rect. X.Max = 100; 
rect. Y.Max = 100; 

if ( !R_init_region_with_rect (&rgnl, &rect) ) 

return FALSE; 
rect. X. Min = 70; 
rect. Y. Min = 70; 
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rect. X.Max = 120; 
rect. Y.Max « 120; 

if ( !R_init_region_with_rect (&rgn2, &rect) ) 

return FALSE; 
if ( !R_union_list_equals(&rgnl, &rgn2) ) 

return FALSE; 
delta. X = 5; 
delta. Y = 5; 

for (i = 0; i < NUM_ITERATIONS; i + + ) 
{ 

R_translate_region(fiergn2, fcdelta) ; 
if { !R_union_list_equals (&rgnl , &rgn2)) 
return FALSE ; 

} 

ticks_new = GetTickCount ( ) - ticks_new; 

ticks_old = GetTickCount () ; 
rect.X.Min = 50; 
rect.Y.Min = 50; 
rect. X.Max * 100; 
rect. Y.Max = 100; 

if ( !R_init_region_with_rect (&rgn3, &rect) ) 

return FALSE; 
rect.X.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn4 , &rect) ) 

return FALSE; 
if ( !R_union_equals (&rgn3 , &rgn4) ) 

return FALSE; 
delta.X = 5; 
delta. Y = 5; 

for (i = 0; i < NUM — ITERATIONS ; i++) 
{ 

R_translate_region(&rgn4, &delta) ; 
if (!R_union_equals(&rgn3, &rgn4)) 
return FALSE; 

} 

ticks_old = GetTickCount ( ) - ticks_old; 

i f ( R_compare ( fcrgnl , &rgn3 ) ) 

sprintf(buf, "New & Old Region Implementations match. \n"); 

else 

sprintffbuf, "New & Old Region Implementations DO NOT match. \n"); 
Ou t put DebugS t ring (buf ) ; 

sprintf (buf, "Union Timings - New=%d vs Old=%d\n", ticks_new, ticks_old) 
OutputDebugString (buf ) ; 

//R_output_region_as_debug_string ( "New Region Description", fcrgnl) ; 
//R_output_region_as_debug_string ( "Old Region Description", &rgn3) ; 

/* 

* Intersection Test. 
*/ 

R_empty_region(&rgn2) ; 
R_empty_region(&rgn4) ; 
rect .X.Min « 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2 , &rect) ) 

return FALSE; 
delta.X = 5; 
delta. Y «= 5; 

for (i = 0; i < NUM_ITERATIONS ; i++) 
( 

if ( !R_intersection_list (&rgn5, &rgnl, &rgn2)) 
return FALSE ; 
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i f ( I R_intersect ion ( &rgn6 , &rgn3 , &rgn2 ) ) 

return FALSE; 
if ( lR_compare(&rgn5, &rgn6)) 
{ 

sprintf(buf, "New & Old Region Implementations DO NOT match. \n B ); 
OutputDebugString (buf ) ; 

) 

R_empty_region(&rgn5) ; 
R_empty_region(&rgn6) ; 
Retranslate region (&rgn2 , &delta) ; 

} 

ticks_new = GetTickCount () ; 
R_empty_r eg ion ( &rgn2 ) ; 
rect.X.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2, &rect) ) 

return FALSE; 
delta. X = 5; 
delta. Y = 5; 

for (i = 0; i < NUM_ITERATIONS; i++) 
{ 

if ( !R_intersection_list (&rgn5, &rgnl, &rgn2) ) 

return FALSE; 
R_empty_region(&rgn5) ; 
R_translate_region(&rgn2, fcdelta) ; 

} 

ticks_new = GetTickCount { ) - ticks_new; 

ticks_old = GetTickCount () ; 
R_empty_region ( &rgn2 ) ; 
rect.X.Min = 70; 
rect.Y.Min = 70; 
rect. X.Max = 120; 
rect. Y.Max = 120; 

if ( !R_init_region_with_rect (&rgn2, &rect) ) 

return FALSE; 
delta.X e 5; 
delta. Y = S; 

for (i = 0; i < NUM_ITERATIONS; i++) 
{ 

if ( !R_intersection(&rgn6, &rgn3, &rgn2) ) 

return FALSE; 
R_empty_region (&rgn6) ; 
Retranslate region (&rgn2 , fcdelta) ; 

) 

ticks_old = GetTickCount () - ticks_old; 

sprintf (buf, "Intersection Timings - New=%d vs 01d=%d\n" , ticksjnew, ticks 
OutputDebugString (buf) ; 

//R_output_region_as_debug_string ( "New Region Description", &rgnl) ; 
//R_output_region_as_debug_string("01d Region Description", &rgn3) ; 

R_empty_region (&rgnl) ; 
R_empty_region (&rgn2) ; 
R_empty_region (&rgn3) ; 
R_empty_region (&rgn4) ; 
OutputDebugString { "Done ! !\n") ; 
ftendif 

return TRUE; 
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The claims defining the invention are as follows: 
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1 . A method of creating an image, said image to be formed by rendering and 

compositing at least a plurality of graphical objects, each said object having a 

5 predetermined outline, said method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality regions, each 
said region being defined by at least one region outline substantially following at least 
one of said predetermined outlines or parts thereof and being substantially formed by 
segments of a virtual grid encompassing said space; 
10 manipulating said regions to determine a plurality of further regions, wherein each 

said further region has a corresponding compositing expression; 

classifying said further regions according to at least one attribute of said graphical 
objects within said further regions; 

modifying each said corresponding compositing expression according to a 
15 classification of each said further region to form an augmented compositing expression 
for each said further region; and 

compositing said image using each of said augmented compositing expressicms. 

2. A method according to claim 1, wherein said attribute is selected from 
20 the group consisting of colour, opacity and object outline. 

3. A method according to claims 1 or 2, wherein said manipulating said 
regions comprises applying set operations to said regions. 

25 4. A method according to claim 3, wherein said set operations include 

difference and/or intersection operations. 

5. A method according to any one of the preceding claims, wherein said 
grid is regularly spaced and preferably orthogonally based. 



30 



6. A method according to any one of claims 1 to 4, wherein said grid is 
irregularly shaped. 



7. A method according to any one of claims 1 to 6, wherein the compositing 
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expression is a hierarchically structured representation of the image. 

8. A method according to any one of claims 1 to 7, wherein said image is at 
least in part a pixel-based image. 

5 

9. A method according to any one of the preceding claims, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

10. A method according to claim 9, wherein said compositing expression is 
10 optimized based on a value of said flag for contributing objects. 

11. A method according to any one of the preceding claims, wherein a 
wholly opaque object in said region acts to eliminate one or more objects within said 
region from said compositing expressions. 

15 

12. A method according to any one of the preceding claims, wherein a 
wholly transparent object in said region eliminates at least itself from said compositing 
expression. 

20 13. A method according to any one of claims 1 to 12, wherein said modifying 

comprises modifying a manner in which said compositing expression is evaluated without 
modifying said hierarchically structured representation. 

14. A method of creating an image, said image to be formed by rendering 
25 and compositing at least a plurality of graphical objects, each said object having a 
predetermined outline, said method comprising the steps of: 

dividing a space in which said outlines are defined into a plurality regions, each 
said region being defined by at least one region outline substantially following at least 
one of said predetermined outlines or parts thereof and being substantially formed by 
30 segments of a virtual grid encompassing said space, wherein each object has two region 
outlines arranged either side of said predetermined outline to thus define three regions for 
each said object, and wherein each said region has a corresponding compositing 
expression; 

classifying said regions according to at least one attribute of said graphical objects 
35 within said regions; 
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modifying each said corresponding compositing expression according to a 
classification of each said region to form an augmented compositing expression for each 
said region; and 

compositing said image using each of said augmented compositing expressions. 

5 

15. A method according to claim 14, wherein said attribute is selected from 
the group consisting of colour, opacity and object outline. 

16. A method according to any one of claims 14 or 15, wherein said grid is 
1 0 regularly spaced and preferably orthogonally based. 

17. A method according to any one of claims 14 to 16, wherein said grid is 
irregularly shaped. 

15 18. A method according to any one of claims 14 to 17, wherein said 

compositing expression is a hierarchically structured representation of the image. 

19. A method according to any one of claims 14 to 18, wherein said image is 
at least in part a pixel-based image. 

20 

20. A method according to any one of claims 14 to 19, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

21. A method according to claim 20, wherein said compositing expression is 
25 optimized based on a value of said flag for contributing objects. 

22. A method according to any one of claims 14 to 21, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 
said compositing expressions. 

30 23. A method according to any one of claims 14 to 22, wherein a wholly 

transparent object in said region eliminates at least itself from said compositing 
expression. 



35 



24. A method according to any one of claims 14 to 23, wherein said 
modifying comprises modifying a manner in which said compositing expression is 
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evaluated without modifying said hierarchically structured representation. 

25. An apparatus for creating an image, said image to be formed by rendering 
and compositing at least a plurality of graphical objects, each said object having a 

5 predetermined outline, said apparatus comprising: 

dividing means for dividing a space in which said outlines are defined into a 
plurality regions, each said region being defined by at least one region outline 
substantially following at least one of said predetermined outlines or parts thereof and 
being substantially formed by segments of a virtual grid encompassing said space; 

10 manipulating means for manipulating said regions to determine a plurality of 

further regions, wherein each said further region has a corresponding compositing 
expression; 

classifying means for classifying said further regions according to at least one 
attribute of said graphical objects within said further regions; 
15 modifying means for modifying each said corresponding compositing expression 

according to a classification of each said further region to form an augmented 
compositing expression for each said further region; and 

compositing means for compositing said image using each of said augmented 
compositing expressions. 

20 

26. An apparatus according to claim 25, wherein said attribute is selected 
from the group consisting of colour, opacity and object outline. 

27. An apparatus according to claims 25 or 26, wherein said manipulating 
25 aid regions comprises applying set operations to said regions. 

28. An apparatus according to claim 27, wherein said set operations include 
difference and/or intersection operations. 

30 29. An apparatus according to any one of claims 25 to 28, wherein said grid 

is regularly spaced and preferably orthogonally based. 

30. An apparatus according to any one of claims 25 to 28, wherein said grid 
is irregularly shaped. 

35 
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31. An apparatus according to any one of claims 25 to 30, wherein said 
compositing expression is a hierarchically structured representation of the image. 

32. An apparatus according to any one of claims 25 to 31, wherein said 
5 image is at least in part a pixel-based image. 

33. An apparatus according to any one of claims 25 to 32, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 



10 34. An apparatus according to claim 33, wherein said compositing expression 

is optimized based on a value of said flag for contributing objects. 

35. An apparatus according to any one of claims 25 to 34, wherein a wholly 
opaque object in said region acts to eliminate one or more objects within said region from 

1 5 said compositing expressions. 

36. An apparatus according to any one of claims 25 to 35, wherein a wholly 
transparent object in said region eliminates at least itself from said compositing 
expression. 

20 

37. An apparatus according to any one of claims 25 to 36, wherein said 
modifying comprises modifying a manner in which said compositing expression is 
evaluated without modifying said hierarchically structured representation. 

25 38. An apparatus for creating an image, said image to be formed by rendering 

and compositing at least a plurality of graphical objects, each said object having a 
predetermined outline, said apparatus comprising: 

dividing means for dividing a space in which said outlines are defined into a 
plurality regions, each said region being defined by at least one region outline 

30 substantially following at least one of said predetermined outlines or parts thereof and 
being substantially formed by segments of a virtual grid encompassing said space, 
wherein each object has two region outlines arranged either side of said predetermined 
outline to thus define three regions for each said object, and wherein each said region has 
a corresponding compositing expression; 

35 classifying means for classifying said regions according to at least one attribute of 
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said graphical objects within said regions; 

modifying means for modifying each said corresponding compositing expression 
according to a classification of each said region to form an augmented compositing 
expression for each said region; and 

compositing means for compositing said image using each of said augmented 
compositing expressions. 

39. An apparatus according to claim 38, wherein said attribute is selected 
from the group consisting of colour, opacity and object outline. 

40. An apparatus according to any one of claims 38 or 39, wherein said grid 
is regularly spaced and preferably orthogonally based. 

41. method according to any one of claims 38 to 40, wherein said grid is 
1 5 irregularly shaped. 

42. An apparatus according to any one of claims 38 to 41, wherein said 
compositing expression is a hierarchically structured representation of the image. 

20 43. • An apparatus according to any one of claims 38 to 42, wherein said 

image is at least in part a pixel-based image. 

44. An apparatus according to any one of claims 38 to 43, wherein a flag is 
stored to indicate whether data of an object is opaque or ordinary. 

25 

45. An apparatus according to claim 44, wherein said compositing expression ' 
is optimized based on a value of said flag for contributing objects. 

46. An apparatus according to any one of claims 38 to 45, wherein a wholly 
30 opaque object in said region acts to eliminate one or more objects within said region from 

said compositing expressions. 



35 



47. An apparatus according to any one of claims 38 to 46, wherein a wholly 
transparent object in said region eliminates at least itself from said compositing 
expression. 
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48. An apparatus according to any one of claims 38 to 47, wherein said 
modifying comprises modifying a manner in which said compositing expression is 
evaluated without modifying said hierarchically structured representation. 

5 

49. A computer program product including a computer readable medium 
having a plurality of software modules for creating an image, said image to be formed by 
rendering and compositing at least a plurality of graphical objects, each said object 
having a predetermined outline, said computer program product comprising: 

10 dividing module for dividing a space in which said outlines are defined into a 

plurality regions, each said region being defined by at least one region outline 
substantially following at least one of said predetermined outlines or parts thereof and 
being substantially formed by segments of a virtual grid encompassing said space; 

manipulating module for manipulating said regions to determine a plurality of 

15 further regions, wherein each said further region has a corresponding compositing 
expression; 

classifying module for classifying said further regions according to at least one 
attribute of said graphical objects within said further regions; 

modifying module for modifying each said corresponding compositing expression 
20 according to a classification of each said further region to form an augmented 
compositing expression for each said further region; and 

compositing module for compositing said image using each of said augmented 
compositing expressions. 

25 50. A computer program product according to claim 49, wherein said 

attribute is selected from the group consisting of colour, opacity and object outline. 

51. A computer program product according to claims 49 or 50, wherein said 
manipulating said regions comprises applying set operations to said regions. 



30 



52. A computer program product according to claim 51, wherein said set 
operations include difference and/or intersection operations. 



35 



53. A computer program product according to any one of claims 49 to 52, 
wherein said grid is regularly spaced and preferably orthogonally based. 
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54. A computer program product according to any one of claims 49 to 52, 
wherein said grid is irregularly shaped. 

5 55. A computer program product according to any one of claims 49 to 54, 

wherein said compositing expression is a hierarchically structured representation of the 
image. 

56. A computer program product according to any one of claims 49 to 55, 
10 wherein said image is at least in part a pixel-based image. 

57. A computer program product according to any one of claims 49 to 56, 
wherein a flag is stored to indicate whether data of an object is opaque or ordinary. 

15 58. A computer program product according to claim 57, wherein said 

compositing expression is optimized based on a value of said flag for contributing 
objects. 

59. A computer program product according to any one of claims 49 to 58, 
20 wherein a wholly opaque object in said region acts to eliminate one or more objects 

within said region from said compositing expressions. 

60. A computer program product according to any one of claims 49 to 59, 
wherein a wholly transparent object in said region eliminates at least itself from said 

25 compositing expression. 

61. A computer program product according to any one of claims 49 to 60, 
wherein said modifying comprises modifying a manner in which said compositing 
expression is evaluated without modifying said hierarchically structured representation. 

30 

62. A computer program product including a computer readable medium 
having a plurality of software modules for creating an image, said image to be formed by 
rendering and compositing at least a plurality of graphical objects, each said object 
having a predetermined outline, said computer program product comprising: 

35 dividing module for dividing a space in which said outlines are defined into a 
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plurality regions, each said region being defined by at least one region outline 
substantially following at least one of said predetermined outlines or parts thereof and 
being substantially formed by segments of a virtual grid encompassing said space, 
wherein each object has two region outlines arranged either side of said predetermined 
5 outline to thus define three regions for each said object, and wherein each said region has 
a corresponding compositing expression; 

classifying module for classifying said regions according to at least one attribute 
of said graphical objects within said regions; 

modifying module for modifying each said corresponding compositing expression 
10 according to a classification of each said region to form an augmented compositing 
expression for each said region; and 

compositing module for compositing said image using each of said augmented 
compositing expressions. 

15 63. A computer program product according to claim 62, wherein said 

attribute is selected from the group consisting of colour, opacity and object outline. 

64. A computer program product according to any one of claims 62 or 63, 
wherein said grid is regularly spaced and preferably orthogonally based. 

20 

65. method according to any one of claims 62 to 64, wherein said grid is 
irregularly shaped. 

66. A computer program product according to any one of claims 62 to 65, 
25 wherein said compositing expression is a hierarchically structured representation of the 

image. 



67. A computer program product according to any one of claims 62 to 66, 
wherein said image is at least in part a pixel-based image. 

30 

68. A computer program product according to any one of claims 62 to 67, 
wherein a flag is stored to indicate whether data of an object is opaque or ordinary. 

69. A computer program product according to claim 68, wherein said 
35 compositing expression is optimized based on a value of said flag for contributing 
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objects. 

70. A computer program product according to any one of claims 62 to 69, 
wherein a wholly opaque object in said region acts to eliminate one or more objects 
within said region from said compositing expressions. 

71. A computer program product according to any one of claims 62 to 70, 
wherein a wholly transparent object in said region eliminates at least itself from said 
compositing expression. 

72. A computer program product according to any one of claims 62 to 71, 
wherein said modifying comprises modifying a manner in which said compositing 
expression is evaluated without modifying said hierarchically structured representation. 

73. A method of creating an image substantially as herein described with 
reference to any one of the embodiments as illustrated in Figs. 4 to 22. 

74. An apparatus for creating an image substantially as herein described with 
reference to any one of the embodiments as illustrated in Figs. 4 to 22. 

75. A computer program product substantially as herein described with 
reference to any one of the embodiments as illustrated in Figs. 4 to 22. 

DATED this Twentieth Day of August 1 999 
Canon Kabushiki Kaisha 
Patent Attorneys for the Applicant 
SPRUSON & FERGUSON 
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